## Tcl9.0.3/Tk9.0.3 Documentation > Tk C API > CrtPhImgFmt

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    Tk_CreatePhotoImageFormat — 写真影像の為の新しいファイル書式を定義する　 define new file format for photo images
  SYNOPSIS
    #include <tk.h>
    Tk_CreatePhotoImageFormatVersion3(formatVersion3Ptr)
    Tk_CreatePhotoImageFormat(formatPtr)
  引数 ARGUMENTS
    const Tk_PhotoImageFormatVersion3 *formatVersion3Ptr (入力in)
    const Tk_PhotoImageFormat *formatPtr (入力in)
  説明 DESCRIPTION
  NAME
  FILEMATCHPROC
  STRINGMATCHPROC
  FILEREADPROC
  STRINGREADPROC
  FILEWRITEPROC
  STRINGWRITEPROC
  METADATA INTERFACE
  METADATA KEYS
  METADATA INPUT
  汎データ出力 METADATA OUTPUT
  VERSION 2 INTERFACE
  構文 SYNOPSIS
  引数 ARGUMENTS
    const Tk_PhotoImageFormat *formatPtr (入力in)
  説明 DESCRIPTION
  FILEMATCHPROC
  STRINGMATCHPROC
  FILEREADPROC
  STRINGREADPROC
  FILEWRITEPROC
  STRINGWRITEPROC
  SEE ALSO
  KEYWORDS

### NAME

Tk_CreatePhotoImageFormat — 写真影像の為の新しいファイル書式を定義する　 define new file format for photo images

### SYNOPSIS

#include <tk.h>
Tk_CreatePhotoImageFormatVersion3(formatVersion3Ptr)
Tk_CreatePhotoImageFormat(formatPtr)

### 引数 ARGUMENTS

const Tk_PhotoImageFormatVersion3 *formatVersion3Ptr (入力in)
  汎データ機能を含む新しいファイル書式を定義する構造｡ Structure that defines the new file format including metadata functionality.

const Tk_PhotoImageFormat *formatPtr (入力in)
  新しいファイル書式を定義する構造｡ Structure that defines the new file format.

### 説明 DESCRIPTION

Tk_CreatePhotoImageFormatVersion3 は写真影像の使用の為の影像データの新しいファイル形式を定義するために起動される｡影像ファイル形式の実装の符号命令は影像ファイル形式操作子､又は短的に操作子から呼出される｡写真影像符号はファイルからの読み書きに使える操作子のリストを維持する｡ある操作子は文字列からの影像データの読出し､又は影像データから文字列形式への移送を運営している｡使用者は -format 影像構成設定指示項目を伴うどれかの操作子か､写真影像副命令の read and write を使う為の -format 追加附加子かを指定できる｡ Tk_CreatePhotoImageFormatVersion3 is invoked to define a new file format for image data for use with photo images. The code that implements an image file format is called an image file format handler, or handler for short. The photo image code maintains a list of handlers that can be used to read and write data to or from a file. Some handlers may also support reading image data from a string or converting image data to a string format. The user can specify which handler to use with the -format image configuration option or the -format option to the read and write photo image subcommands.

代りの第2版Tk_CreatePhotoImageFormatは､同じ機能を有すが､ 処理子に影像の汎データ辞書取得や戻しを許容しない｡ 下のVERSION 2 INTERFACE節に記述されている｡ The alternate version 2 function Tk_CreatePhotoImageFormat has identical functionality, but does not allow the handler to get or return the metadata dictionary of the image. It is described in section VERSION 2 INTERFACE below.

影像ファイル書式操作子は手続函数に加えてTk_PhotoImageFormatVersion3構造の 集まりで構成される､後者は､影像ファイル書式の名前､及び､ファイルとこの書式の文字列を扱う為に､操作子に提供された六個の手続函数への指示子 を含む｡ Tk_PhotoImageFormatVersion3は次の欄を含む: An image file format handler consists of a collection of procedures plus a Tk_PhotoImageFormatVersion3 structure, which contains the name of the image file format and pointers to six procedures provided by the handler to deal with files and strings in this format. The Tk_PhotoImageFormatVersion3 structure contains the following fields:

    typedef struct {
        const char *name;
        Tk_ImageFileMatchProcVersion3 *fileMatchProc;
        Tk_ImageStringMatchProcVersion3 *stringMatchProc;
        Tk_ImageFileReadProcVersion3 *fileReadProc;
        Tk_ImageStringReadProcVersion3 *stringReadProc;
        Tk_ImageFileWriteProcVersion3 *fileWriteProc;
        Tk_ImageStringWriteProcVersion3 *stringWriteProc;
    } Tk_PhotoImageFormatVersion3;

操作子は六個の手続函数全てに実装を提供する必要はない｡ 譬えば､文字列データを操作する手続き函数は､ その中で影像データが二進数で保存される書式は提供されない筈､又､ 従って､ヌル文字を含み得る｡ もし､どれかの手続函数が実装されない場合､ Tk_PhotoImageFormat構造内の対応する指示子はヌルに設定される｡ 操作子は､もし､fileReadProc手続函数を提供する場合は､ fileMatchProc手続函数を提供せねばならない､且つ､ stringReadProc手続函数を提供する場合は､stringMatchProc手続函数も｡ The handler need not provide implementations of all six procedures. For example, the procedures that handle string data would not be provided for a format in which the image data are stored in binary, and could therefore contain null characters. If any procedure is not implemented, the corresponding pointer in the Tk_PhotoImageFormat structure should be set to NULL. The handler must provide the fileMatchProc procedure if it provides the fileReadProc procedure, and the stringMatchProc procedure if it provides the stringReadProc procedure.

#### NAME

formatPtr->nameは影像型の為の名前を提供する｡ 一たびTk_CreatePhotoImageFormatVersion3が帰ると､ この名前は-format写真映像構成設定内と 副命令の指示項目で使われる｡ 写真映像の為の取扱い説明書の頁(photo(n))は､ 如何に影像ファイル書式がその名前を基準に選択され､且つ､ -format指示項目に値が与えられるかを､記述する｡ formatPtr->nameの第一文字は､ASCII文字揃い (即ち､文字A-Zの内の一つ)から､ 大文字であってはならない｡ その様な名前は､遺産の対話機能にのみの対応に使われる(下記参照)｡ formatPtr->name provides a name for the image type. Once Tk_CreatePhotoImageFormatVersion3 returns, this name may be used in the -format photo image configuration and subcommand option. The manual page for the photo image (photo(n)) describes how image file formats are chosen based on their names and the value given to the -format option. The first character of formatPtr->name must not be an uppercase character from the ASCII character set (that is, one of the characters A-Z). Such names are used only for legacy interface support (see below).

#### FILEMATCHPROC

与えられたファイル内のデータを読むに適した影像ファイル形式操作子について捜索する時に､formatPtr->fileMatchProc は呼出すべき Tk の為の手続函数の番地を提供する｡ formatPtr->fileMatchProc は次の原型に合致しなければならない: formatPtr->fileMatchProc provides the address of a procedure for Tk to call when it is searching for an image file format handler suitable for reading data in a given file. formatPtr->fileMatchProc must match the following prototype:

    typedef int Tk_ImageFileMatchProcVersion3(
            Tcl_Interp *interp,
            Tcl_Channel chan,
            const char *fileName,
            Tcl_Obj *format,
            Tcl_Obj *metadataIn,
            int *widthPtr,
            int *heightPtr,
            Tcl_Obj *metadataOut);

fileName 引数は chan として読む為に開けた影像データを含むファイルの名前である｡ format 引数は -format 指示項目の為に与えられた値を含むが任意付加子が指定されていない場合は NULL である｡ metadataInとmetadataOut入力は汎データ辞書を下の METADATA INTERFACE節で記述したように入力し返す｡ もしファイル内のデータがこの操作子によって運営されている形式で現れると formatPtr->fileMatchProc 手続函数は *widthPtr と *heightPtr の箇所に影像の巾と高さを夫々保存し､ 1.を返すことになり､それ以外の場合は 0.を返す｡ The fileName argument is the name of the file containing the image data, which is open for reading as chan. The format argument contains the value given for the -format option, or NULL if the option was not specified. metadataIn and metadataOut inputs and returns a metadata dictionary as described in section METADATA INTERFACE below. If the data in the file appears to be in the format supported by this handler, the formatPtr->fileMatchProc procedure should store the width and height of the image in *widthPtr and *heightPtr respectively, and return 1. Otherwise it should return 0.

#### STRINGMATCHPROC

与えられた文字列からデータを読むに適した影像ファイル形式操作子について捜索する時に､formatPtr->stringMatchProc は呼出すべき Tk の為の手続函数の番地を提供する｡ formatPtr->stringMatchProc provides the address of a procedure for Tk to call when it is searching for an image file format handler suitable for reading data from a given string. formatPtr->stringMatchProc must match the following prototype:

    typedef int Tk_ImageStringMatchProcVersion3(
            Tcl_Interp *interp,
            Tcl_Obj *data,
            Tcl_Obj *format,
            Tcl_Obj *metadataIn,
            int *widthPtr,
            int *heightPtr,
            Tcl_Obj *metadataOut);

data 引数は影像データを含む対象を指す｡ format 引数は -format 指示項目の為に与えられた値を含むが任意付加子が指定されていない場合は NULL である｡ metadataInとmetadataOutは､ 下記のMETADATA INTERFACE節内に記述された汎データ辞書を 入力し返す｡ もし文字列内のデータがこの操作子によって運営されている形式で現れると formatPtr->stringMatchProc 手続函数は *widthPtr and *heightPtr の箇所に影像の巾と高さを夫々保存し､ 1 を返すことになり､それ以外の場合は 0 を返す｡ The data argument points to the object containing the image data. The format argument contains the value given for the -format option, or NULL if the option was not specified. metadataIn and metadataOut inputs and returns a metadata dictionary as described in section METADATA INTERFACE below. If the data in the string appears to be in the format supported by this handler, the formatPtr->stringMatchProc procedure should store the width and height of the image in *widthPtr and *heightPtr respectively, and return 1. Otherwise it should return 0.

#### FILEREADPROC

影像ファイルから写真影像にデータを読む為に､formatPtr->fileReadProc は呼出すべき Tk の為の手続函数の番地を提供する｡ formatPtr->fileReadProc は次の原型に合致しなければならない: formatPtr->fileReadProc provides the address of a procedure for Tk to call to read data from an image file into a photo image. formatPtr->fileReadProc must match the following prototype:

    typedef int Tk_ImageFileReadProcVersion3(
            Tcl_Interp *interp,
            Tcl_Channel chan,
            const char *fileName,
            Tcl_Obj *format,
            Tcl_Obj *metadataIn,
            PhotoHandle imageHandle,
            int destX, int destY,
            int width, int height,
            int srcX, int srcY,
            Tcl_Obj *metadataOut);

interp 引数はその中で､影像データを読む為に起動される解釈実行機能である; それは不都合を報告する為に使われる｡影像データは chan として読む為に開けた fileName と名付けたファイルにありる｡ format 引数は -format 指示項目の為に与えられた値を含むが任意付加子が指定されていない場合は NULL である｡ファイル内のデータ､又はその副影像は操作子 imageHandle によって識別された写真影像に読込まれる｡ファイル内の副影像はその寸法が 巾 x 高さ でありその左上隅の座標は(srcX,srcY)である｡それは写真影像内に Tk_PhotoPutBlock 手続函数によって､その左上隅が座標(destX,destY)に保存される｡ metadataInとmetadataOutは､METADATA INTERFACE下の節の 記述に従って､汎データ辞書を入力し返す｡ 返り値は標準 Tcl 返り値である｡ The interp argument is the interpreter in which the command was invoked to read the image; it should be used for reporting errors. The image data is in the file named fileName, which is open for reading as chan. The format argument contains the value given for the -format option, or NULL if the option was not specified. The image data in the file, or a subimage of it, is to be read into the photo image identified by the handle imageHandle. The subimage of the data in the file is of dimensions width x height and has its top-left corner at coordinates (srcX,srcY). It is to be stored in the photo image with its top-left corner at coordinates (destX,destY) using the Tk_PhotoPutBlock procedure. metadataIn and metadataOut inputs and returns a metadata dictionary as described in section METADATA INTERFACE below. The return value is a standard Tcl return value.

#### STRINGREADPROC

文字列から写真影像にデータを読む為に､formatPtr->stringReadProc は呼出すべき Tk の為の手続函数の番地を提供する｡ formatPtr->stringReadProc は次の原型に合致しなければならない: formatPtr->stringReadProc provides the address of a procedure for Tk to call to read data from a string into a photo image. formatPtr->stringReadProc must match the following prototype:

    typedef int Tk_ImageStringReadProcVersion3(
            Tcl_Interp *interp,
            Tcl_Obj *data,
            Tcl_Obj *format,
            Tcl_Obj *metadataIn,
            PhotoHandle imageHandle,
            int destX, int destY,
            int width, int height,
            int srcX, int srcY,
            Tcl_Obj *metadataOut);

interp 引数はその中で､影像データを読む為に起動される解釈実行機能である; それは不都合を報告する為に使われる｡影像データは chan として読む為に開けた fileName と名付けたファイルにありる｡ format 引数は -format 指示項目の為に与えられた値を含むが任意付加子が指定されていない場合は NULL である｡ファイル内のデータ､又はその副影像は操作子 imageHandle によって識別された写真影像に読込まれる｡ファイル内の副影像はその寸法が 巾 x 高さ でありその左上隅の座標は(srcX,srcY)である｡それは写真影像内に Tk_PhotoPutBlock 手続函数によって､その左上隅が座標(destX,destY)に保存される｡ metadataInとmetadataOutは､ 下記のMETADATA INTERFACE節内に記述された汎データ辞書を 入力し返す｡ 返り値は標準 Tcl 返り値である｡ The interp argument is the interpreter in which the command was invoked to read the image; it should be used for reporting errors. The data argument points to the image data in object form. The format argument contains the value given for the -format option, or NULL if the option was not specified. The image data in the string, or a subimage of it, is to be read into the photo image identified by the handle imageHandle. The subimage of the data in the string is of dimensions width x height and has its top-left corner at coordinates (srcX,srcY). It is to be stored in the photo image with its top-left corner at coordinates (destX,destY) using the Tk_PhotoPutBlock procedure. metadataIn and metadataOut inputs and returns a metadata dictionary as described in section METADATA INTERFACE below. The return value is a standard Tcl return value.

#### FILEWRITEPROC

formatPtr->fileWriteProc provides the address of a procedure for Tk to call to write data from a photo image to a file. formatPtr->fileWriteProc must match the following prototype:

    typedef int Tk_ImageFileWriteProcVersion3(
            Tcl_Interp *interp,
            const char *fileName,
            Tcl_Obj *format,
            Tcl_Obj *metadataIn,
            Tk_PhotoImageBlock *blockPtr);

interp 引数はその中で､影像を書く為に起動される解釈実行機能である; それは不都合を報告する為に使われる｡書くべき影像データは記憶域の中にあり､ blockPtr によって指される Tk_PhotoImageBlock 構造によって記述される; 詳細は取扱説明書の FindPhoto(3) を参照されたい｡ fileName 引数はそこにデータを書くべきファイルの名前を与える文字列を指す｡ format 引数は -format 指示項目の為に与えられた値を含むが任意付加子が指定されていない場合は NULL である｡形式文字列は､形式の名前の後に臨時の文字を含むかもしれない｡それが適切な場合は､ formatPtr->fileWriteProc 手続函数は影像ファイルに関する更なる詳細を指定する為にこれ等の文字を解釈するかもしれない｡ metadataInは駆動譜が出力データ内に含む汎データ鍵を含むかもしれない｡ 返り値は標準 Tcl 返り値である｡ The interp argument is the interpreter in which the command was invoked to write the image; it should be used for reporting errors. The image data to be written are in memory and are described by the Tk_PhotoImageBlock structure pointed to by blockPtr; see the manual page FindPhoto(3) for details. The fileName argument points to the string giving the name of the file in which to write the image data. The format argument contains the value given for the -format option, or NULL if the option was not specified. The format string can contain extra characters after the name of the format. If appropriate, the formatPtr->fileWriteProc procedure may interpret these characters to specify further details about the image file. metadataIn may contain metadata keys that a driver may include into the output data. The return value is a standard Tcl return value.

#### STRINGWRITEPROC

formatPtr->stringWriteProc provides the address of a procedure for Tk to call to translate image data from a photo image into a string. formatPtr->stringWriteProc must match the following prototype:

    typedef int Tk_ImageStringWriteProcVersion3(
            Tcl_Interp *interp,
            Tcl_Obj *format,
            Tcl_Obj *metadataIn,
            Tk_PhotoImageBlock *blockPtr);

interp 引数はその中で､影像を変換する為に起動される解釈実行機能である; それは不都合を報告する為に使われる｡変換されるべき影像データは記憶域の中にあり､ blockPtr によって指される Tk_PhotoImageBlock 構造によって記述される; 詳細は取扱説明書の FindPhoto(3) を参照されたい｡文字列に関するデータは解釈実行機能の interp 結果に入れられる｡ format 引数は -format 指示項目の為に与えられた値を含むが任意付加子が指定されていない場合は NULL である｡形式文字列は､形式の名前の後に臨時の文字を含むかもしれない｡それが適切な場合は､ formatPtr->stringWriteProc 手続函数は影像ファイルに関する更なる詳細を指定する為にこれ等の文字を解釈するかもしれない｡ metadataInは駆動譜が出力データ内に含む汎データ鍵を含むかもしれない｡ 返り値は標準 Tcl 返り値である｡ The interp argument is the interpreter in which the command was invoked to convert the image; it should be used for reporting errors. The image data to be converted are in memory and are described by the Tk_PhotoImageBlock structure pointed to by blockPtr; see the manual page FindPhoto(3) for details. The data for the string should be put in the interpreter interp result. The format argument contains the value given for the -format option, or NULL if the option was not specified. The format string can contain extra characters after the name of the format. If appropriate, the formatPtr->stringWriteProc procedure may interpret these characters to specify further details about the image file. metadataIn may contain metadata keys that a driver may include into the output data. The return value is a standard Tcl return value.

### METADATA INTERFACE

影像書式は影像点地図の記述を含み､且つ､影像解像度や註釈の様な 追加情報を含み得る｡ 影像汎データは影像ファイルから読まれ､そして､ 辞書鍵を含む記述譜水準に渡され､辞書鍵に含まれて､影像の汎データ特性に入れられる｡ 影像汎データはファイル書込みや映像データ出力で､影像データに書かれる｡ Image formats contain a description of the image bitmap and may contain additional information like image resolution or comments. Image metadata may be read from image files and passed to the script level by including dictionary keys into the metadata property of the image. Image metadata may be written to image data on file write or image data output.

#### METADATA KEYS

汎データはどの鍵も含み得る｡ 駆動譜は取扱い説明書内に記述された､ 辞書鍵の揃いのみを操作する｡ 現在定められている系駆動譜の為の鍵に関する写真映像取扱い説明書頁を参照されたい｡ The metadata may contain any key. A driver will handle only a set of dictionary keys documented in the documentation. See the photo image manual page for currently defined keys for the system drivers.

次の規則が名称汎データ鍵への手引きを与える: The following rules may give guidance to name metadata keys:

- 略号は大文字である｡ Abbreviations are in upper case.

- 単語は小文字の米国英語(固有名詞を除く) Words are in US English in small case (except proper nouns)

- 垂直解像度 DPI は DPI/側面 で説明する｡ 理由は､幾つかの影像書式は､外観を定め､解像度の値がない｡ Vertical DPI is expressed as DPI/aspect. The reason is, that some image formats may feature aspect and no resolution value.

#### METADATA INPUT

それぞれの駆動譜函数はTcl対象指示子metadataInを假引数として得る｡ この假引数は駆動譜函数への汎データ辞書入力に奉仕する｡ 汎データ辞書が空である旗徴へのヌルもあり得る｡ Each driver function gets a Tcl object pointer metadataIn as parameter. This parameter serves to input a metadata dict to the driver function. It may be NULL to flag that the metadata dict is empty.

汎データ駆動譜符号は､汎データ鍵が何かを確認する為に切取られる: A typical driver code snipped to check for a metadata key is:

    if (NULL != metadataIn) {
        Tcl_Obj *itemData;
        Tcl_DictObjGet(interp, metadataIn, Tcl_NewStringObj("Comment",-1),
                &itemData));
        // use value reference in itemData
    }

次の命令の-metadata命令自自項目データが駆動譜に渡される: image createとconfigureとputとreadとdata と write ｡ もし､どの-metadata命令指示項目も利用不能か､ 与えられないと､影像の汎データ特性は次の命令を使って駆動譜に渡される: cgetとconfigureとdata と write ､以上｡ The -metadata command option data of the following commands is passed to the driver: image create, configure, put, read, data and write. If no -metadata command option available or not given, the metadata property of the image is passed to the driver using the following commands: cget, configure, data and write.

注意すべきは､configureを使って､他の指示項目無しに､ 影像の-metadata特性を設定すると､どの駆動譜函数も起動しない｡ Note that setting the -metadata property of an image using configure without any other option does not invoke any driver function.

汎データ辞書は､点地図表現に関わる駆動譜に､指示項目を渡すには適してない､ 理由は､影像点地図は汎データ変化上には生成されない｡ 書式文字列はこの目的の為に使われるべきである｡ The metadata dictionary is not suited to pass options to the driver related to the bitmap representation, as the image bitmap is not recreated on a metadata change. The format string should be used for this purpose.

#### 汎データ出力 METADATA OUTPUT

影像が､合致し､そして､読込駆動譜函数は､ それを返す為に用意された汎データ辞書内に鍵を設定し得る これ等の函数はTcl対象指示子metadataOutを假引数として得る｡ metadataOut は汎データ返却は要求されてない事(put, read副命令)を示す為に､NULL になり得る｡ metadataOutによって､指される変数は､ もし､汎データ返却が参画されると(image create 命令, configure副命令)､ 空の非共有辞書対象に初期化される｡ 駆動譜は､汎データを返す為に､この対象内に辞書鍵を設定する｡ 合致函数がもし成功すると､metadataOut指示子が相当する読込み函数に渡される｡ The image match and read driver functions may set keys in a prepared metadata dict to return them. Those functions get a Tcl object pointer metadataOut as parameter. metadataOut may be NULL to indicate, that no metadata return is required (put, read subcommands). The variable pointed to by metadataOut is initialized to an empty unshared dict object if metadata return is attended (image create command, configure subcommand). The driver may set dict keys in this object to return metadata. If a match function succeeds, the metadataOut pointer is passed to the corresponding read function.

見本の駆動譜符号命令の断片は: A sample driver code snippet is:

    if (NULL != metadataOut) {
        Tcl_DictObjPut(NULL, metadataOut, Tcl_NewStringObj("XMP",-1),
                Tcl_NewStringObj(xmpMetadata));
    }

駆動譜によって返される汎データ鍵は､ 既存の影像の汎データ特性に､又は -metadata命令行指示項目によって与えられた汎データ辞書内､に併合される｡ 記述譜水準では､image create命令とconfigure手段は駆動譜から汎データを返す｡ The metadata keys returned by the driver are merged into the present metadata property of the image or into the metadata dict given by the -metadata command line option. At the script level, the command image create and the configure method may return metadata from the driver.

書式文字列指示項目又は､汎データ鍵は駆動譜内部の汎データの生成に影響し得る｡ 譬えば､高価な汎データ鍵は､書式文字れる指示項目又は､汎データ入力鍵に依存する｡ Format string options or metadata keys may influence the creation of metadata within the driver. For example, the creation of an expensive metadata key may depend on a format string option or on a metadata input key.

### VERSION 2 INTERFACE

第2版対話機能は駆動譜が汎データ辞書を入力や出力の為に使う可能性を含まない｡ Version 2 Interface does not include the possibility for the driver to use the metadata dict for input or output.

#### 構文 SYNOPSIS

#include <tk.h>

Tk_CreatePhotoImageFormat(formatPtr)

#### 引数 ARGUMENTS

const Tk_PhotoImageFormat *formatPtr (入力in)
  新しいファイル書式を定める構造｡ Structure that defines the new file format.

#### 説明 DESCRIPTION

第2版対話機能を使う駆動譜は､駆動譜登録の為に､ Tk_CreatePhotoImageFormatを起動する｡ Tk_PhotoImageFormat構造は次の欄を含む: A driver using the version 2 interface invokes Tk_CreatePhotoImageFormat for driver registration. The Tk_PhotoImageFormat structure contains the following fields:

    typedef struct {
        const char *name;
        Tk_ImageFileMatchProc *fileMatchProc;
        Tk_ImageStringMatchProc *stringMatchProc;
        Tk_ImageFileReadProc *fileReadProc;
        Tk_ImageStringReadProc *stringReadProc;
        Tk_ImageFileWriteProc *fileWriteProc;
        Tk_ImageStringWriteProc *stringWriteProc;
    } Tk_PhotoImageFormat;

#### FILEMATCHPROC

formatPtr->fileMatchProc は次の原型に整合しなければならない: formatPtr->fileMatchProc must match the following prototype:

    typedef int Tk_ImageFileMatchProc(
            Tcl_Channel chan,
            const char *fileName,
            Tcl_Obj *format,
            int *widthPtr,
            int *heightPtr,
            Tcl_Interp *interp);

#### STRINGMATCHPROC

formatPtr->stringMatchProc は次の原型に整合しなければならない: formatPtr->stringMatchProc must match the following prototype:

    typedef int Tk_ImageStringMatchProc(
            Tcl_Obj *data,
            Tcl_Obj *format,
            int *widthPtr,
            int *heightPtr,
            Tcl_Interp *interp);

#### FILEREADPROC

formatPtr->fileReadProc は次の原型に整合しなければならない: formatPtr->fileReadProc must match the following prototype:

    typedef int Tk_ImageFileReadProc(
            Tcl_Interp *interp,
            Tcl_Channel chan,
            const char *fileName,
            Tcl_Obj *format,
            PhotoHandle imageHandle,
            int destX, int destY,
            int width, int height,
            int srcX, int srcY);

#### STRINGREADPROC

formatPtr->stringReadProc は次の原型に整合しなければならない: formatPtr->stringReadProc must match the following prototype:

    typedef int Tk_ImageStringReadProc(
            Tcl_Interp *interp,
            Tcl_Obj *data,
            Tcl_Obj *format,
            PhotoHandle imageHandle,
            int destX, int destY,
            int width, int height,
            int srcX, int srcY);

#### FILEWRITEPROC

formatPtr->fileWriteProc は次の原型に整合しなければならない: formatPtr->fileWriteProc must match the following prototype:

    typedef int Tk_ImageFileWriteProc(
            Tcl_Interp *interp,
            const char *fileName,
            Tcl_Obj *format,
            Tk_PhotoImageBlock *blockPtr);

#### STRINGWRITEPROC

formatPtr->stringWriteProc は次の原型に整合しなければならない: formatPtr->stringWriteProc must match the following prototype:

    typedef int Tk_ImageStringWriteProc(
            Tcl_Interp *interp,
            Tcl_Obj *format,
            Tk_PhotoImageBlock *blockPtr);

### SEE ALSO

Tk_FindPhoto, Tk_PhotoPutBlock

### KEYWORDS

photo image, image file
Copyright © 1994 The Australian National University
Copyright © 1994-1997 Sun Microsystems, Inc.