zformat_Create

Create an instance of a file format handler for a particular project map. This function, or zformat_CreateGeneric, must be called at least once by a file input/output plugin before it can be used to save or load map files.

ZFORMAT zformat_Create(const char* lpMapName, const char* lpLongName, const char* lpFileExt, const char* lpNativeProgramName);

Null if an error occurred or the format already existed, and otherwise a valid ZFORMAT handle.

Valid project map names currently include:

• “Design map”
• “Heightfield”
• “Water map”
• “Salinity map”
• “Attributes map”
• “Terrain normals”
• “Light map”
• “Texture map”

More will be added in future.

// create my format
ZFORMAT hFormat = zformat_Create("Design map", "L3DT Design Map File", "dmf", "L3DT");
if(!hFormat) {
  // do nothing; this probably means the format already exists.
} else {
  // set the flags
  zformat_SetFlags(hFormat, 
    ZFORMAT_FLAG_NATIVE|
    ZFORMAT_FLAG_MOSAIC|
    ZFORMAT_FLAG_LOAD|
    ZFORMAT_FLAG_SAVE|
    ZFORMAT_FLAG_LOADTILE|
    ZFORMAT_FLAG_SAVETILE); // native I/O and mosaic
}