Loading...
Searching...
No Matches
LegoPalettePresenter Class Reference
Class responsible for presenting and handling palettes for video sequences that require palette management [AI]. More...
#include <legopalettepresenter.h>
Inheritance diagram for LegoPalettePresenter:
Collaboration diagram for LegoPalettePresenter:
Public Member Functions | |
| LegoPalettePresenter () | |
| Constructs the LegoPalettePresenter and initializes its internal state. More... | |
| ~LegoPalettePresenter () override | |
| Cleans up and releases owned resources, including any loaded palette. More... | |
| const char * | ClassName () const override |
| Gets the presenter class name as used for RTTI (run-time type identification) and class dispatch. More... | |
| MxBool | IsA (const char *p_name) const override |
| Implements run-time type identification matching for this presenter. More... | |
| void | ReadyTickle () override |
| Called by the tickle manager when presenter is in Ready state; handles next palette chunk if available. More... | |
| void | Destroy () override |
| Handles destruction and cleanup of palette presenter resources (public destroy invocation). More... | |
| MxResult | ParsePalette (MxStreamChunk *p_chunk) |
| Parses a palette from a chunk in the streaming media resource. More... | |
 Public Member Functions inherited from MxVideoPresenter | |
| MxVideoPresenter () | |
| Constructs a new MxVideoPresenter and initializes internal state. More... | |
| virtual void | LoadHeader (MxStreamChunk *p_chunk) |
| Loads and processes header information from a video stream chunk. More... | |
| virtual void | CreateBitmap () |
| Allocates and sets up the display bitmap for video frame data. More... | |
| virtual void | NextFrame () |
| Advances video playback to the next frame, handling decoding and playback progression. More... | |
| virtual void | LoadFrame (MxStreamChunk *p_chunk) |
| Loads and processes frame data from a video stream chunk. More... | |
| virtual void | PutFrame () |
| Presents the current frame using the chosen output mechanism (e.g., blitting to screen). More... | |
| virtual void | RealizePalette () |
| Loads or establishes the palette for display from the current video format or media. More... | |
| virtual undefined | VTable0x74 () |
| Unknown/potentially format-specific method (VTable0x74). More... | |
| ~MxVideoPresenter () override | |
| Destroys the MxVideoPresenter, releasing owned resources and unregistering from the manager. More... | |
| void | Destroy () override |
| Destroys internal resources for the presenter. More... | |
| virtual LPDIRECTDRAWSURFACE | VTable0x78 () |
| Retrieves the DirectDraw surface used for hardware-accelerated rendering. More... | |
| virtual MxBool | VTable0x7c () |
| Checks if this presenter has either a video frame bitmap or alpha mask available. More... | |
| virtual MxS32 | GetWidth () |
| Returns the width of the current bitmap or alpha mask in pixels. More... | |
| virtual MxS32 | GetHeight () |
| Returns the height of the current bitmap or alpha mask in pixels. More... | |
| const char * | ClassName () const override |
| Returns the run-time class name of this presenter instance. More... | |
| MxBool | IsA (const char *p_name) const override |
| Determines if this object is or derives from a class with the given name. More... | |
| void | ReadyTickle () override |
| Advance logic for the "ready" tickle state. More... | |
| void | StartingTickle () override |
| Advance logic for the "starting" tickle state (frame setup). More... | |
| void | StreamingTickle () override |
| Advance logic for the "streaming" tickle state (typical video playback). More... | |
| void | RepeatingTickle () override |
| Advance logic for the "repeating" tickle state (media looping). More... | |
| void | FreezingTickle () override |
| Advance logic for the "freezing" tickle state (sustain after playback). More... | |
| MxResult | AddToManager () override |
| Adds this presenter to the global video manager. More... | |
| void | EndAction () override |
| Signals the end of the current playback action. More... | |
| MxResult | PutData () override |
| Writes the frame to the display device if appropriate. More... | |
| MxBool | IsHit (MxS32 p_x, MxS32 p_y) override |
| Determines if a point is inside the non-transparent region of frame/alpha. More... | |
| MxS32 | PrepareRects (RECT &p_rectDest, RECT &p_rectSrc) |
| Utility function to adjust source/dest rectangles to stay within allowed bounds. More... | |
| MxBitmap * | GetBitmap () |
| Returns the frame bitmap currently used for this presenter. More... | |
| AlphaMask * | GetAlphaMask () |
| Returns this presenter's alpha mask for hit testing. More... | |
| MxU8 * | GetBitmapStart (MxS32 p_left, MxS32 p_top) |
| Provides a pointer to the start of frame bitmap data at a given coordinate. More... | |
| void | SetBit0 (BOOL p_e) |
| Sets internal miscellaneous state flags. More... | |
| void | SetBit1 (BOOL p_e) |
| void | SetBit2 (BOOL p_e) |
| void | SetBit3 (BOOL p_e) |
| void | SetBit4 (BOOL p_e) |
| BYTE | GetBit0 () |
| Gets internal miscellaneous state flags (bits 0-4). More... | |
| BYTE | GetBit1 () |
| BYTE | GetBit2 () |
| BYTE | GetBit3 () |
| BYTE | GetBit4 () |
| Public Member Functions inherited from MxMediaPresenter | |
| MxMediaPresenter () | |
| [AI] Constructs the presenter, initializing all member variables. More... | |
| ~MxMediaPresenter () override | |
| [AI] Destructor; cleans up and optionally destroys all internal resources as well as the MxDSSubscriber and chunk list/cursor. More... | |
| void | Destroy () override |
| [AI] Cleans up internal resources and resets the presenter to an uninitialized state. More... | |
| MxResult | Tickle () override |
| [AI] Advances the presenter's state and media stream, if any, by tickling (i.e., updating) components. More... | |
| const char * | ClassName () const override |
| [AI] Returns the class name for this presenter (see HandlerClassName()). More... | |
| MxBool | IsA (const char *p_name) const override |
| [AI] Returns TRUE if the provided class name matches this class or any of its parents. More... | |
| void | StreamingTickle () override |
| [AI] Per-frame update when streaming the media stream. More... | |
| void | RepeatingTickle () override |
| [AI] Per-frame update while looping/repeating over known chunks. More... | |
| void | DoneTickle () override |
| [AI] Per-frame update for the "done" state; transitions this presenter to idle and ends the action. More... | |
| MxResult | StartAction (MxStreamController *, MxDSAction *) override |
| [AI] Begins a new media playback action, wiring up the stream and chunk lists as needed. More... | |
| void | EndAction () override |
| [AI] Ends the media playback action, releasing all resources, notifying listeners if necessary. More... | |
| void | Enable (MxBool p_enable) override |
| [AI] Enables or disables media stream playback and transitions state as needed. More... | |
| virtual void | LoopChunk (MxStreamChunk *p_chunk) |
| [AI] Adds a chunk to the looping chunk list, making it available for repeated playback. More... | |
| MxStreamChunk * | CurrentChunk () |
| [AI] Returns a pointer to the current data chunk at the head of the stream, without consuming it. More... | |
| MxStreamChunk * | NextChunk () |
| [AI] Returns the next data chunk in the stream, removing it from the stream queue. More... | |
| Public Member Functions inherited from MxPresenter | |
| MxPresenter () | |
| [AI] Constructor. Initializes internal tickle state and other members. More... | |
| MxResult | Tickle () override |
| [AI] Main tickle handler, called periodically to progress presenter's internal state. More... | |
| virtual void | VTable0x14 () |
| [AI] Reserved for future or specialized use in derived classes. More... | |
| virtual void | ReadyTickle () |
| [AI] Handles the transition and setup for the Ready state. Parses extra action data and advances state. More... | |
| virtual void | StartingTickle () |
| [AI] Handles actions required when first starting presentation. Advances to streaming state. More... | |
| virtual void | StreamingTickle () |
| [AI] Handles periodic updates during the streaming/presentation stage. Advances to repeating state. More... | |
| virtual void | RepeatingTickle () |
| [AI] Handles updates when in a repeating (looping) stage. Advances to freezing state. More... | |
| virtual void | FreezingTickle () |
| [AI] Handles updates during the freezing/suspended state. Advances to done state. More... | |
| ~MxPresenter () override | |
| [AI] Destructor, cleans up resources (base class: does nothing beyond Init). More... | |
| virtual MxResult | AddToManager () |
| [AI] Optional registration with a manager (such as TickleManager); by default does nothing. More... | |
| virtual void | Destroy () |
| [AI] Resets presenter state or cleans up resources after completion/removal. More... | |
| virtual MxResult | StartAction (MxStreamController *, MxDSAction *) |
| [AI] Initiates presenter for a new action, setting up context and state. More... | |
| virtual void | EndAction () |
| [AI] Terminates the current action, notifies listeners and resets state. More... | |
| virtual void | SetTickleState (TickleState p_tickleState) |
| [AI] Forces the tickle state, advancing to the requested lifecycle stage. More... | |
| virtual MxBool | HasTickleStatePassed (TickleState p_tickleState) |
| [AI] Checks if the specified tickle state has ever been passed since last reset. More... | |
| virtual MxResult | PutData () |
| [AI] Allows the presenter to submit pending results or output to the engine. More... | |
| virtual MxBool | IsHit (MxS32 p_x, MxS32 p_y) |
| [AI] Returns TRUE if the given (x, y) falls within hit-test bounds for the presenter (e.g. More... | |
| virtual void | Enable (MxBool p_enable) |
| [AI] Enables or disables this presenter (controls action flags accordingly). More... | |
| const char * | ClassName () const override |
| [AI] Returns the run-time class name for this presenter. More... | |
| MxBool | IsA (const char *p_name) const override |
| [AI] Determines if this object is of (or inherits) the specified named class. More... | |
| MxEntity * | CreateEntity (const char *p_defaultName) |
| [AI] Creates an entity based on action 'extra' data, or uses the provided default name. More... | |
| void | SendToCompositePresenter (MxOmni *p_omni) |
| [AI] Notifies a composite presenter (if one exists) that this presenter wishes to join a group. More... | |
| MxBool | IsEnabled () |
| [AI] Returns whether this presenter is logically enabled (based on the associated action's flags). More... | |
| MxS32 | GetCurrentTickleState () const |
| [AI] Returns the current tickle state. More... | |
| MxPoint32 | GetLocation () const |
| [AI] Returns the presenter's screen location (in pixels). More... | |
| MxS32 | GetX () const |
| [AI] Returns the X coordinate of screen location. More... | |
| MxS32 | GetY () const |
| [AI] Returns the Y coordinate of screen location. More... | |
| MxS32 | GetDisplayZ () const |
| [AI] Returns the display Z (depth) order. More... | |
| MxDSAction * | GetAction () const |
| [AI] Returns the current action being presented. More... | |
| void | SetAction (MxDSAction *p_action) |
| [AI] Sets the action associated with this presenter. More... | |
| void | SetCompositePresenter (MxCompositePresenter *p_compositePresenter) |
| [AI] Sets the composite presenter to notify/join on completion. More... | |
| void | SetDisplayZ (MxS32 p_displayZ) |
| [AI] Sets the display Z (depth) order for the presenter. More... | |
| Public Member Functions inherited from MxCore | |
| MxCore () | |
| [AI] Constructs a new MxCore object and assigns it a unique id. More... | |
| virtual | ~MxCore () |
| [AI] Virtual destructor. Required for correct polymorphic cleanup in derived classes. More... | |
| virtual MxLong | Notify (MxParam &p_param) |
| [AI] Virtual callback notification mechanism. More... | |
| virtual MxResult | Tickle () |
| [AI] Called by tickle managers to allow the object to update itself. More... | |
| virtual const char * | ClassName () const |
| [AI] Returns the runtime class name of this object. More... | |
| virtual MxBool | IsA (const char *p_name) const |
| [AI] Checks whether this object's class type or parents match the given name. More... | |
| MxU32 | GetId () |
| [AI] Gets the unique (per-process) id assigned to this object instance. More... | |
Static Public Member Functions | |
| static const char * | HandlerClassName () |
| Provides the unique class handler name required for presenter dispatching. More... | |
| Static Public Member Functions inherited from MxVideoPresenter | |
| static const char * | HandlerClassName () |
| Returns the class name string for this presenter type. More... | |
| Static Public Member Functions inherited from MxMediaPresenter | |
| static const char * | HandlerClassName () |
| [AI] Gets the class name string for handler dispatch and RTTI emulation. More... | |
| Static Public Member Functions inherited from MxPresenter | |
| static const char * | HandlerClassName () |
| [AI] Returns the handler class name for identification and reflection purposes. More... | |
Additional Inherited Members | |
| Public Types inherited from MxPresenter | |
| enum | TickleState { e_idle = 0 , e_ready , e_starting , e_streaming , e_repeating , e_freezing , e_done } |
| [AI] Represents the state of the presenter's tickle (update) lifecycle. More... | |
| Protected Member Functions inherited from MxVideoPresenter | |
| void | Destroy (MxBool p_fromDestructor) |
| Releases resources and unregisters presenter from the video manager. More... | |
| Protected Member Functions inherited from MxMediaPresenter | |
| void | Init () |
| [AI] Initializes all member variables to a known default state (NULL pointers, etc). More... | |
| void | Destroy (MxBool p_fromDestructor) |
| [AI] Frees all managed resources, owned memory and pointers, optionally preventing destruction of the base class. More... | |
| Protected Member Functions inherited from MxPresenter | |
| virtual void | DoneTickle () |
| [AI] Handles any post-completion logic, resetting to idle state. More... | |
| virtual void | ParseExtra () |
| [AI] Parses additional data from the associated action for configuration or world interaction. More... | |
| void | ProgressTickleState (TickleState p_tickleState) |
| [AI] Helper for advancing the presenter's tickle state and updating transition history. More... | |
| void | Init () |
| [AI] Initializes object state to post-construction defaults. More... | |
| Protected Attributes inherited from MxVideoPresenter | |
| MxBitmap * | m_frameBitmap |
| Bitmap for current video frame. [AI]. More... | |
| AlphaMask * | m_alpha |
| Alpha mask for hit testing. May be null. [AI]. More... | |
| LPDIRECTDRAWSURFACE | m_unk0x58 |
| DirectDraw surface for hardware video rendering. [AI]. More... | |
| MxS16 | m_unk0x5c |
| Loop/advance/frame decode counter. [AI]. More... | |
| FlagBitfield | m_flags |
| Miscellaneous flags for object and UI state. [AI]. More... | |
| MxLong | m_unk0x60 |
| Last freeze time/start of sustain interval. [AI]. More... | |
| Protected Attributes inherited from MxMediaPresenter | |
| MxDSSubscriber * | m_subscriber |
| [AI] Subscriber that provides the stream data (e.g., audio/video chunks) for this presenter. More... | |
| MxStreamChunkList * | m_loopingChunks |
| [AI] Linked list of all chunks available for looping/repeating playback. More... | |
| MxStreamChunkListCursor * | m_loopingChunkCursor |
| [AI] Cursor used to iterate through the loopingChunk list during repeat mode. More... | |
| MxStreamChunk * | m_currentChunk |
| [AI] Currently active data chunk for playback or processing. More... | |
| Protected Attributes inherited from MxPresenter | |
| TickleState | m_currentTickleState |
| [AI] Current state in the tickle lifecycle. More... | |
| MxU32 | m_previousTickleStates |
| [AI] Bitfield representing all tickle states that have already occurred during this lifetime. More... | |
| MxPoint32 | m_location |
| [AI] 2D display location for the presenter. More... | |
| MxS32 | m_displayZ |
| [AI] Z-order value for display stacking. More... | |
| MxDSAction * | m_action |
| [AI] The associated action currently being presented by this presenter. More... | |
| MxCriticalSection | m_criticalSection |
| [AI] Thread synchronization for presenter state and data. More... | |
| MxCompositePresenter * | m_compositePresenter |
| [AI] Owner composite presenter, if any. More... | |
Detailed Description
Class responsible for presenting and handling palettes for video sequences that require palette management [AI].
[AI] LegoPalettePresenter manages MxPalette resources, parses palette data from incoming MxStreamChunk objects (as found in SI file resources), and coordinates with the video subsystem to realize/activate the palette when necessary. It is triggered during "Ready" tickle state of a presentation, and is used for video or animation formats that require explicit palette updates (such as FLC or certain indexed video). [AI]
- See also
- MxVideoPresenter, MxPalette, MxStreamChunk [AI]
Definition at line 14 of file legopalettepresenter.h.
Constructor & Destructor Documentation
◆ LegoPalettePresenter()
| LegoPalettePresenter::LegoPalettePresenter | ( | ) |
Constructs the LegoPalettePresenter and initializes its internal state.
[AI]
Definition at line 14 of file legopalettepresenter.cpp.
◆ ~LegoPalettePresenter()
|
override |
Cleans up and releases owned resources, including any loaded palette.
[AI]
Definition at line 20 of file legopalettepresenter.cpp.
Member Function Documentation
◆ ClassName()
|
inlineoverridevirtual |
Gets the presenter class name as used for RTTI (run-time type identification) and class dispatch.
[AI]
- Returns
- Class handler name string ("LegoPalettePresenter") [AI]
Reimplemented from MxCore.
Definition at line 40 of file legopalettepresenter.h.
◆ Destroy()
|
overridevirtual |
Handles destruction and cleanup of palette presenter resources (public destroy invocation).
[AI]
Reimplemented from MxPresenter.
Definition at line 46 of file legopalettepresenter.cpp.
◆ HandlerClassName()
|
inlinestatic |
Provides the unique class handler name required for presenter dispatching.
[AI]
- Returns
- The string literal "LegoPalettePresenter". [AI]
Definition at line 30 of file legopalettepresenter.h.
◆ IsA()
|
inlineoverridevirtual |
Implements run-time type identification matching for this presenter.
[AI]
- Parameters
-
p_name Name to check for class match, compared case-sensitively. [AI]
- Returns
- True if p_name matches this class or any parent class; otherwise false. [AI]
Reimplemented from MxCore.
Definition at line 50 of file legopalettepresenter.h.
◆ ParsePalette()
| MxResult LegoPalettePresenter::ParsePalette | ( | MxStreamChunk * | p_chunk | ) |
Parses a palette from a chunk in the streaming media resource.
[AI]
[AI] Expects the chunk data to match the LEGO Island .SI palette chunk format: leading 40 bytes (usually image/palette header) followed by 256 RGBQUAD entries; creates an MxPalette from the color table. [AI]
- Parameters
-
p_chunk Pointer to the streaming data chunk containing palette resource. [AI]
- Returns
- SUCCESS if palette was parsed and created, FAILURE otherwise. [AI]
Definition at line 52 of file legopalettepresenter.cpp.
◆ ReadyTickle()
|
overridevirtual |
Called by the tickle manager when presenter is in Ready state; handles next palette chunk if available.
[AI]
[AI] This method checks if there is palette data available from the associated subscriber, parses the palette, and if successful, sends it to the VideoManager to be realized (applied for rendering). [AI]
Reimplemented from MxPresenter.
Definition at line 77 of file legopalettepresenter.cpp.
The documentation for this class was generated from the following files:
