CRM64Pro::Scene

Scene class. More...

Detailed Description

Scene class.

Public Member Functions
bool	info (Sint32 iMode=-1) override
	Request detailed Scene object information.
const string &	getName () const override
	Get the name.
Uint32	getID () const override
	Get the ID.
Sint32	getWidth () const
	Get the total width of the level in pixels.
Sint32	getHeight () const
	Get the total height of the level in pixels.
Sint32	getLayerCount (eSceneLayerType eType=SLT_EMPTY) const
	Get the number of allocated layer slots.
eSceneLayerType	getLayerType (Sint32 layer) const
	Get the type of a specific layer.
Sint32	createLayer (const string &sName, eSceneLayerType eType, Sint32 idLayer=-1, Sint32 iParam1=0, Sint32 iParam2=0)
	Create a new layer.
Sint32	addLayer (SceneLayer *pLayer, Sint32 idLayer=-1)
	Add an existing layer instance.
bool	closeLayer (Sint32 layer)
	Close and destroy a layer.
bool	clear ()
	Free all resources of current map (layer maps and tilesets).
bool	setViewport (SDL_Rect *rect)
	Set the desired viewport.
bool	getViewport (SDL_Rect *out) const
	Get the current viewport.
bool	setBackgroundColor (Uint32 iRGBA)
	Set background color.
Uint32	getBackgroundColor () const
	Get background color.
string	getModificationDate () const
	Get the map modification date (last save date).
string	getCreationDate () const
	Get the map creation date (first save date).
Sint32	createTileSet (Sint32 idRes, Sint32 globalID=-1)
	Create a TileSet from a memory resource (Image or Tile).
Sint32	createTileSet (const string &sCDCFile, const string &sResourceName, Sint32 globalID=-1)
	Create a TileSet from a CDC archive resource.
Sint32	createTileSetFromFile (const string &sPath, Sint32 globalID=-1, Sint32 iTileWidth=-1, Sint32 iTileHeight=-1)
	Create a TileSet from a file on disk.
bool	closeTileSet (Sint32 iTN)
	Close and destroy a given TileSet.
Sint32	getTileResourceID (Sint32 iTN)
	Resolve a Global Tile ID to its internal CRM64Pro Tile Resource ID.
eSceneTileSetType	getTileSetType (Sint32 iTN)
	Get the TileSet type.
bool	getTileSetSource (Sint32 iTN, eSceneStorageMode &eMode, string &sPath, string &sFilename)
	Get the storage metadata for a TileSet.
bool	setTileSetSource (Sint32 iTN, eSceneStorageMode eMode, const string &sPath, const string &sFilename)
	Set the storage metadata for a TileSet.
bool	setLayerFeatures (Sint32 layer, eSceneLayerFeature eLF, bool bEnable)
	Set the layer features.
eSceneLayerFeature	getLayerFeatures (Sint32 layer) const
	Get the layer features.
bool	pause ()
	Pause all active layers.
bool	resume ()
	Resume all active layers.
bool	setLayerAlphaMod (Sint32 layer, Sint32 alpha)
	Set layer alpha modulation used for rendering this layer.
Sint32	getLayerAlphaMod (Sint32 layer) const
	Get layer alpha modulation.
bool	setLayerParallaxRatio (Sint32 layer, float fPRX, float fPRY)
	Set the layer parallax ratio.
Sint32	getLayerParallaxRatio (Sint32 layer, float *fPRX, float *fPRY) const
	Get current layer parallax ratio.
bool	setCameraMode (Sint32 iLayer, eSceneCameraMode eMode)
	Set camera mode for a layer.
eSceneCameraMode	getCameraMode (Sint32 iLayer) const
	Get camera mode for a layer.
bool	setCameraParams (Sint32 iLayer, const SceneCameraParams &params)
	Set camera parameters for a layer.
bool	getCameraParams (Sint32 iLayer, SceneCameraParams *pOut) const
	Get camera parameters for a layer.
bool	setCameraTarget (Sint32 iLayer, Sint32 iTargetObjectLayer, Sint32 iTargetObjectID)
	Set camera target by object layer and object ID.
bool	setCameraTarget (Sint32 iLayer, SceneObject *pTarget)
	Set camera target by object pointer.
bool	clearCameraTarget (Sint32 iLayer)
	Clear camera target binding for a layer.
bool	setCameraPosition (Sint32 iLayer, float fX, float fY, bool bDisableNextSmooth=false)
	Set camera absolute position and force manual mode.
bool	setCameraBounds (Sint32 iLayer, const SDL_FRect *pBounds)
	Set optional camera clamp bounds override for a layer.
bool	getCameraBounds (Sint32 iLayer, SDL_FRect *pOut) const
	Get explicit camera clamp bounds override for a layer.
bool	setCameraOffsetCallback (Sint32 iLayer, SCENE_CameraOffsetCallback fnOffset, void *pUserData)
	Set offset callback for ::SCM_OFFSET mode.
bool	setCameraShake (Sint32 iLayer, float amplitudePx, Uint32 durationMs, float falloff=5.0f)
	Set a transient render-only camera shake for a layer.
bool	clearCameraShake (Sint32 iLayer)
	Clear active camera shake on a layer.
Sint32	setLayerPosition (Sint32 layer, const Position &xpos=Position(PH_KEEP), const Position &ypos=Position(PH_KEEP))
Sint32	getLayerPosition (Sint32 layer, float *xpos, float *ypos) const
	Get the current layer position (in pixels).
bool	setLayerOnUpdateEnd (Sint32 layer, SCENE_OnLayerCallback myfunc)
	Set an event function (onUpdateEnd) to be called when the engine finishes updating the layer.
SCENE_OnLayerCallback	getLayerOnUpdateEnd (Sint32 layer)
	Get current onUpdateEnd event function if any.
bool	setLayerOnRenderEnd (Sint32 layer, SCENE_OnLayerCallback myfunc)
	Set an event function (onRenderEnd) to be called when the engine finishes rendering the layer.
SCENE_OnLayerCallback	getLayerOnRenderEnd (Sint32 layer)
	Get current onRenderEnd event function if any.
void	setOnTriggerEvent (SceneObject::SCENE_OnTriggerEvent fn, void *pUserData=nullptr)
	Set a global trigger event callback.
bool	getLayerName (Sint32 layer, string &sName) const
	Get the layer name.
bool	setLayerName (Sint32 layer, const string &sName)
	Set a new layer name.
bool	setDebugOverlay (eSceneDebugOverlay eFlags, bool bEnable)
	Enable or disable one or more unified debug overlay flags.
bool	isDebugOverlayEnabled (eSceneDebugOverlay eFlags) const
	Check if all requested debug overlay flags are enabled.
bool	setDebugOverlayColor (eSceneDebugOverlay eFlag, Uint32 iColor)
	Set debug overlay color for a specific overlay flag.
Uint32	getDebugOverlayColor (eSceneDebugOverlay eFlag) const
	Get debug overlay color for a specific overlay flag.
SceneLayerTile *	accessLayerTile (Sint32 layer)
	Get a tile layer by Scene layer index.
SceneLayerObject *	accessLayerObject (Sint32 layer)
	Get an object layer by Scene layer index.
SceneLayerImage *	accessLayerImage (Sint32 layer)
	Get an image layer by Scene layer index.
bool	screenToWorld (Sint32 sx, Sint32 sy, float *wx, float *wy, Sint32 layer=0) const
	Convert screen coordinates to world coordinates.
bool	screenToCell (Sint32 sx, Sint32 sy, Sint32 *cx, Sint32 *cy, Sint32 layer=0) const
	Convert screen coordinates to tile cell indices.
bool	worldToScreen (float wx, float wy, float *sx, float *sy, Sint32 layer=0)
	Convert world coordinates to screen coordinates.
bool	mouseToWorld (float *wx, float *wy, Sint32 layer=0) const
	Convert current mouse position to world coordinates.
bool	mouseToCell (Sint32 *cx, Sint32 *cy, Sint32 layer=0) const
	Convert current mouse position to tile cell indices.
Sint32	update (Sint32 layer=0)
	Update status of the Scene.
Sint32	render (Sint32 layer=0, Sint32 idRes=0)
	Render the visible layers.
Sint32	importLayerFromFile (Sint32 layer, const string &sFile, const string &sLayerName, Sint32 tileSizeX, Sint32 tileSizeY, float maxDevPercentage=100.0, Sint32 iCK=-1)
	Import an image file (BMP or PNG) into a layer.
Sint32	importLayerFromImage (Sint32 layer, Sint32 idImg, const string &sLayerName, Sint32 tileSizeX, Sint32 tileSizeY, float maxDevPercentage=100.0, Sint32 iCK=-1)
	Import an image into a layer.
Sint32	exportLayerToFile (Sint32 layer, const string &sFile)
	Export a layer to an external PNG image.
Sint32	exportLayerToImage (Sint32 layer, Sint32 idImg)
	Export a layer to an image.
Sint32	save (const string &sTMXFile, const string &sLevelName="", const string &sCDCFile="", bool bForce=false)
	Save level to native C64SCENE format (TMX-based).
void	setObjectFactory (ISceneObjectFactory *pFactory)
	Set the object factory for creating game objects from Tiled types.
ISceneObjectFactory *	getObjectFactory ()
	Get the current object factory.
bool	isObjectLayer (Sint32 iLayer)
	Check if a layer is an object layer.

Member Function Documentation

save()

Sint32 CRM64Pro::Scene::save	(	const string &	sTMXFile,
		const string &	sLevelName = "",
		const string &	sCDCFile = "",
		bool	bForce = false )

Save level to native C64SCENE format (TMX-based).

Saves the Scene level to the native C64SCENE format, which is based on Tiled TMX v1.10 (orthogonal, right-down render order). The level can be saved as standalone TMX files on disk or packaged within a CDC archive, with flexible control over TileSet resource locations.

TileSet source handling:

• If bForce=false (default): Resources respect their original storage mode:
  • SSM_DISK: References existing disk file (path/filename preserved)
  • SSM_CDC: References existing CDC archive using "cdc://archive/resource" format
  • SSM_INTERNAL: Always exported to current destination (created from in-memory objects)
• If bForce=true: All resources consolidated to target destination:
  • Saving to disk: All resources exported to same directory as TMX
  • Saving to CDC: All resources packaged into same CDC archive

Output modes:

1. Disk mode (sCDCFile=""): Creates .tmx file and separate .tsx/.png files in sTMXFile directory
2. CDC mode (sCDCFile specified): Packages resources into CDC archive (behavior depends on bForce)

Parameters

sTMXFile	string containing [directory]+filename+[extension] for the TMX file. Directory separators '\' and '/' are supported. Extension optional.
sLevelName	Optional level name override. If empty, uses current level name.
sCDCFile	Optional CDC archive path. If empty, saves as external disk files. If specified, saves to CDC archive (behavior depends on bForce flag).
bForce	If true, consolidates all resources to target destination (disk or CDC). If false (default), respects original resource storage modes.

Returns

0 on success, or a negative error code on failure.

See also

load()