NOTE : This project is not currently in development and is totally unsupported. These pages are here for information only.

getImageName

Declaration

extern "C" status_t getImageName(char* &name);

Description

This function is entirely optional. The function returns a status_t error code to indicate the success of the operation. Any of the status_t error codes can be used, but it is suggested that you stick to using B_NO_ERROR for success and B_ERROR for failure. The function is passed a char* which you must allocate memory for, and then fill with the filename of the current image.

Example Implementation - Kodak DC210 Plugin

status_t getImageName(char* &name) { //With this camera, details of all the files can be obtained with one command //This is done only when the list of images changes, or when the camera is opened. if (haveigotfilenames == false) if (getfiledata() < B_NO_ERROR) return(B_ERROR); //The names are stored in a STL map of image numbers to names. //The required name is found. map<int, char*>::iterator pname; pname = imagenames.find(currentpicturenumber); name = strdup(pname->second); return(B_NO_ERROR); }