cgmNCARG - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

CGM_open, CGM_close, CGM_lseek, CGM_read, CGM_write, CGM_directory, CGM_freeDirectory,
CGM_printDirectory, CGM_getInstr, CGM_flushGetInstr, CGM_putInstr, CGM_flushOutputInstr,
CGM_initMetaEdit, CGM_termMetaEdit, CGM_copyFrames, CGM_deleteFrames, CGM_mergeFrames
CGM_moveFrames, CGM_readFrames, CGM_valid, CGM_writeFile, CGM_writeFrames,
CGM_appendFrames - ການເຮັດວຽກຂອງ Metafile ຮູບພາບຂອງຄອມພິວເຕີ

SYNTAX

#include

Cgm_fd CGM_open(metafile, ຂະ ໜາດ, ທຸງ, ຮູບແບບ)
char * metafile;
ລົງນາມ ຂະຫນາດ;
int ທຸງ;
int ຮູບແບບ;

int CGM_close(cgm_fd)
Cgm_fd cgm_fd;

int CGM_lseek(cgm_fd, ຊົດເຊີຍ)
Cgm_fd cgm_fd;
int ຊົດເຊີຍ;

int CGM_read(cgm_fd, buf)
Cgm_fd cgm_fd;
ລົງນາມ char *buf;

int CGM_write(cgm_fd, buf)
Cgm_fd cgm_fd;
ລົງນາມ char *buf;

Directory * CGM_directory(cgm_fd)
Cgm_fd cgm_fd;

void CGM_freeDirectory(dir)
Directory * dir;

void CGM_printDirectory(dir)
Directory * dir;

int CGM_getInstr(cgm_fd, instr)
Cgm_fd cgm_fd;
Instr * instr ;

void CGM_flushGetInstr(cgm_fd)
Cgm_fd cgm_fd;

int CGM_putInstr(cgm_fd, instr)
Cgm_fd cgm_fd;
Instr * instr ;

int CGM_flushOutputInstr(cgm_fd)
Cgm_fd cgm_fd;

Directory *CGM_initMetaEdit ( metafile , ຂະ ໜາດ)
char * metafile;
ລົງນາມ int ຂະຫນາດ;

int CGM_termMetaEdit()

Directory * CGM_copyFrames (ເລີ່ມ​ຕົ້ນ​, ຕົວເລກ, ເປົ້າ​ຫມາຍ )
ລົງນາມ int ເລີ່ມຕົ້ນ;
int ຕົວເລກ;
ລົງນາມ int ເປົ້າ​ຫມາຍ;

Directory * CGM_deleteFrames (ເລີ່ມ​ຕົ້ນ​, ຕົວເລກ)
ລົງນາມ int ເລີ່ມຕົ້ນ,
ຕົວເລກ;

Directory *CGM_mergeFrames(ລຸ່ມສຸດ, ດ້ານເທິງ)
ລົງນາມ ທາງລຸ່ມ, ເທິງ;

Directory * CGM_moveFrames (ເລີ່ມ​ຕົ້ນ​, ຕົວເລກ, ເປົ້າ​ຫມາຍ)
ລົງນາມ int ເລີ່ມຕົ້ນ, ຕົວເລກ, ເປົ້າ​ຫມາຍ;

Directory * CGM_readFrames(metafile, ເລີ່ມຕົ້ນ, ຕົວເລກ, ເປົ້າ​ຫມາຍ, ຂະ ໜາດ)
char * metafile;
ລົງນາມ int ເລີ່ມຕົ້ນ;
int ຕົວເລກ;
ລົງນາມ int ເປົ້າ​ຫມາຍ, ຂະຫນາດ;

int *CGM_validCGM( metafile )
char * metafile;

int CGM_writeFile( metafile )
char * metafile;

int CGM_writeFrames(metafile, ເລີ່ມຕົ້ນ, ຕົວເລກ)
char * metafile;
ລົງນາມ ເລີ່ມຕົ້ນ, ຕົວເລກ;

int CGM_appendFrames(metafile, ເລີ່ມຕົ້ນ, ຕົວເລກ)
char * metafile;
ລົງນາມ ເລີ່ມຕົ້ນ, ຕົວເລກ;

ລາຍລະອຽດ

ການໂຕ້ຖຽງ cgm_fd ຫມາຍເຖິງຕົວອະທິບາຍໄຟລ໌ທີ່ຖືກຕ້ອງທີ່ສ້າງຂຶ້ນສໍາລັບການອ່ານຫຼືຂຽນ, ເປັນ
ທີ່​ເຫມາະ​ສົມ​ໂດຍ CGM_open. CGM_ອ່ານ, CGM_directory, CGM_getInstr ແລະ CGM_flushGetInstr
ຕ້ອງການຕົວອະທິບາຍໄຟລ໌ເປີດສໍາລັບການອ່ານ. CGM_write, CGM_getInstr,CGM_flushGetInstr ແລະ
CGM_flushOutputInstr ຮຽກຮ້ອງໃຫ້ມີ Cgm_fd ເປີດສໍາລັບການຂຽນ. CGM_close ແລະ CGM_lseek ຈະ
ຍອມຮັບທີ່ຖືກຕ້ອງ Cgm_fd.

ໄດ້ ຂະຫນາດ argument ຫມາຍເຖິງຂະຫນາດບັນທຶກ CGM ໃນ bytes. ສໍາລັບ NCAR CGM ຄ່ານີ້ແມ່ນ
1440​.

buff ເປັນຕົວຊີ້ໄປຫາຫນ່ວຍຄວາມຈໍາທີ່ຈັດສັນໂດຍຜູ້ໃຊ້ຂອງຂະຫນາດ ຂະຫນາດ. ການເກັບຮັກສານີ້ຈະຖືກໃຊ້ສໍາລັບ
buffering input ແລະ output ຂອງ CGM_ອ່ານ ແລະ CGM_write ຕາມລໍາດັບ.

ໄດ້ dir ການໂຕ້ຖຽງແມ່ນຕົວຊີ້ໄປຫາ a Directory ໂຄງສ້າງທີ່ສ້າງຂຶ້ນດ້ວຍ CGM_directory or
CGM_initMetaEdit. dir ເປັນຊັບພະຍາກອນສ່ວນຕົວທີ່ຄວນ ບໍ່ ໄດ້ຮັບການດັດແກ້ໂດຍກົງໂດຍ
ຜູ້ໃຊ້. ຊຸດຂອງ macro ສະດວກສະບາຍແມ່ນສະຫນອງໃຫ້ສໍາລັບຈຸດປະສົງນີ້ໃນ cgm_tools.h.

ໄດ້ ການເລີ່ມຕົ້ນ, num ແລະ ເປົ້າ​ຫມາຍ arguments ຖືກນໍາໃຊ້ເພື່ອແກ້ໄຂຕົວເລກກອບໃນ metafile ເປັນ
ແກ້ໄຂດ້ວຍໜຶ່ງໃນຄຳສັ່ງ: CGM_copyFrames, CGM_deleteFrames, CGM_readFrames,
CGM_moveFrames, CGM_writeFrames ແລະ CGM_mergeFrames. ໄດ້ ການເລີ່ມຕົ້ນ ການໂຕ້ຖຽງແມ່ນຄັ້ງທໍາອິດ
ກອບໃນລໍາດັບຂອງ num frame(s) ເພື່ອດໍາເນີນການແກ້ໄຂໃນ. ເປົ້າ​ຫມາຍ ແມ່ນຄ້າຍຄືກັນ
to ການເລີ່ມຕົ້ນ ແລະຖືກນໍາໃຊ້ໂດຍຄໍາສັ່ງທີ່ຕ້ອງການສອງທີ່ຢູ່ກອບເຊັ່ນ: ຄັດລອກ. ທີ່ຢູ່
ເລີ່ມຕົ້ນຢູ່ທີ່ສູນ.

CGM_open
ຄໍາສັ່ງນີ້ແມ່ນສ້າງແບບຈໍາລອງຫຼັງຈາກ unix ເປີດ ຄໍາສັ່ງ. ມັນຈະເປີດ CGM ສໍາລັບການອ່ານ
ຫຼື​ການ​ຂຽນ​ຕາມ​ທີ່​ກໍາ​ນົດ​ໄວ້​ໂດຍ​ ທົງ ການໂຕ້ຖຽງແລະກັບຄືນ a Cgm_fd ຕົວອະທິບາຍໄຟລ໌.
ໄດ້ ທົງ ແລະ ເປີດ ຕົວກໍານົດການແມ່ນສົ່ງໂດຍກົງໃສ່ລະບົບ ເປີດ ຄໍາສັ່ງ.
ສໍາລັບຄໍາອະທິບາຍລາຍລະອຽດຂອງການໂຕ້ຖຽງທັງສອງນີ້ເບິ່ງ ເປີດ(2).

CGM_close
ລຶບຕົວອະທິບາຍໄຟລ໌. ປີ້ນກັບກັນຂອງ CGM_open, ທະເລສາບ ໃກ້(2).

CGM_ອ່ານ
CGM_ອ່ານ ຄວາມ​ພະ​ຍາ​ຍາມ​ທີ່​ຈະ​ອ່ານ​ ຂະຫນາດ bytes ຈາກວັດຖຸອ້າງອີງໂດຍຜ່ານ
ຕົວອະທິບາຍ cgm_fd. ຂະຫນາດ ແມ່ນ​ກໍາ​ນົດ​ຢູ່​ໃນ​ການ​ສ້າງ​ຂອງ​ cgm_fd by CGM_open. CGM_ອ່ານ
ຕອບຈໍານວນ bytes ສໍາເລັດການອ່ານ. ສູນແມ່ນສົ່ງຄືນໃນ EOF ແລະ a
ຕົວເລກລົບຫມາຍເຖິງຄວາມຜິດພາດທີ່ເກີດຂຶ້ນ. ການໂທລະບົບ unix ອ່ານ ຖືກເອີ້ນໂດຍ
CGM_ອ່ານ, ທະເລສາບ ອ່ານ(2).

CGM_write
ຄວາມພະຍາຍາມທີ່ຈະຂຽນບັນທຶກດຽວຂອງ ຂະຫນາດ bytes ຈາກ buff ຈາກວັດຖຸທີ່ອ້າງອີງ
by cgm_edit ບ່ອນທີ່ ຂະຫນາດ ແມ່ນຕົວກໍານົດການຂະຫນາດການບັນທຶກສະຫນອງໃຫ້ຢູ່ໃນການສ້າງຂອງ
cgm_fd. ຂຽນ ສົ່ງຄືນຈຳນວນຂອງໄບທ໌ທີ່ຂຽນສຳເລັດ. ຜົນຕອບແທນທາງລົບ
ຕົວເລກຫມາຍເຖິງຄວາມຜິດພາດທີ່ເກີດຂຶ້ນ. ການໂທລະບົບ unix ຂຽນ ຖືກເອີ້ນໂດຍ
CGM_write, ທະເລສາບ ຂຽນ(2).

CGM_lseek
ເລື່ອນຕົວຊີ້ໄຟລ໌ຂອງ cgm_fd to ຊົດເຊີຍ ໄບຕ໌. ຫຼັງ​ຈາກ​ສໍາ​ເລັດ​ຜົນ​ສໍາ​ເລັດ​
ໄຟລ໌ pointer offset ປະຈຸບັນຖືກສົ່ງຄືນ. ຄ່າກັບຄືນທາງລົບແມ່ນຄວາມຜິດພາດ. ໄດ້
ການໂທລະບົບ unix ຊອກຫາ ຖືກເອີ້ນໂດຍ CGM_lseek, ທະເລສາບ ຊອກຫາ(2).

CGM_directory
ສ້າງຕາຕະລາງເນື້ອໃນສໍາລັບ metafile ອ້າງອີງໂດຍ cgm_fd. ຕອບຕົວຊີ້
ກັບຕາຕະລາງປະເພດນີ້ Directory. ເນື້ອໃນຂອງໄດເລກະທໍລີປະກອບມີຈໍານວນ
metafiles, ຈໍານວນຂອງກອບ, ບັນທຶກການຊົດເຊີຍສໍາລັບແຕ່ລະກອບ, ຄວາມຍາວຂອງກອບໃນບັນທຶກ,
ລາຍລະອຽດກອບທາງເລືອກແລະສະຖານະພາບ metafile. ຊ່ອງຂໍ້ມູນເຫຼົ່ານີ້ແມ່ນຫມາຍເຖິງການອ່ານ
ພຽງ​ແຕ່​ແລະ​ຄວນ​ຈະ​ໄດ້​ຮັບ​ການ​ອ້າງ​ອີງ​ພຽງ​ແຕ່​ມາ​ໂຄ​ສະ​ດວກ​ສະ​ບາຍ​ທີ່​ສະ​ຫນອງ​ໃຫ້​ໃນ​
cgm_tools.h. ຕົວຊີ້ NULL ຖືກສົ່ງຄືນເມື່ອລົ້ມເຫລວ.

CGM_freeDirectory
ຫນ່ວຍຄວາມຈໍາຟຣີຈັດສັນໃຫ້ໄດເລກະທໍລີທີ່ສ້າງຂຶ້ນໂດຍ CGM_directory or CGM_initMetaEdit.

CGM_printDirectory
ພິມເນື້ອໃນຂອງໄດເລກະທໍລີທີ່ຊີ້ໄປຫາ dir ກັບຜົນຜະລິດມາດຕະຖານ.

CGM_getInstr,
ເອົາຄໍາແນະນໍາຕໍ່ໄປໃນໄຟລ໌ອ້າງອີງໂດຍ cgm_edit ແລະປ່ຽນເປັນ
ຮູບ​ແບບ​ທີ່​ໃຊ້​ໄດ້​ຊີ້​ໄປ​ໂດຍ​ instr. CGM_getInstr ສະຫນອງການໂຕ້ຕອບກັບ
metafile ສໍາລັບການສະກັດອົງປະກອບ CGM. ຜູ້ໃຊ້ບໍ່ຈໍາເປັນຕ້ອງກັງວົນກ່ຽວກັບ
ຮູບແບບຖານສອງຂອງ metafile. ທົ່ງນາຂອງ Instr ແມ່ນໄດ້ອະທິບາຍໄວ້ໃນ
cgm_tools.h. ຜູ້ໃຊ້ຄວນສັງເກດວ່າຄວາມຍາວຂອງຂໍ້ມູນສູງສຸດທີ່ອະນຸຍາດໃຫ້ກັບຄືນ
ໃນ invocation ດຽວແມ່ນ 32760 bytes. ມາດຕະຖານ CGM ອະນຸຍາດໃຫ້ສູງເຖິງ 32767 bytes
ເກັບຮັກສາໄວ້ໃນຄໍາແນະນໍາດຽວ. ແຕ່ 32767 ບໍ່ແມ່ນຕົວເລກທີ່ດີທີ່ຈະເຮັດວຽກກັບ.
ຖ້າຄວາມຍາວຂອງຂໍ້ມູນຂອງຄໍາແນະນໍາ CGM ເກີນ 32760 bytes, ຊີ້ບອກໂດຍ
ປຸ້ຍ ເພີ່ມເຕີມ ທຸງ, ການຮຽກຮ້ອງຕໍ່ໄປຂອງ CGM_getInstr ຈະສົ່ງຄືນສ່ວນທີ່ເຫຼືອ
ຂໍ້ມູນເຖິງຂີດຈຳກັດດຽວກັນ, ແລະອື່ນໆ. CGMgetInstr ຕ້ອງການທີ່ຖືກຕ້ອງ Cgm_fd ເປີດສໍາລັບ
ການອ່ານ. ສໍາລັບຄໍາອະທິບາຍກ່ຽວກັບ CGM ເບິ່ງມາດຕະຖານ ANSI.

CGM_flushGetInstr
ລ້າງ buffer ການປ້ອນຂໍ້ມູນທີ່ໃຊ້ໂດຍ CGM_getInstr. CGM_getInstr buffers ເນື້ອໃນຂອງ
CGM ແລະພຽງແຕ່ປະຕິບັດການອ່ານຕົວຈິງຕາມຄວາມຈໍາເປັນ. ຖ້າຜູ້ໃຊ້ຕ້ອງການອື່ນໆ, ຫຼັງຈາກນັ້ນ
ການເຂົ້າເຖິງການອ່ານຕາມລໍາດັບໄປຫາ CGM ມັນເປັນສິ່ງຈໍາເປັນທີ່ຈະລ້າງ buffer ການປ້ອນຂໍ້ມູນ
ກ່ອນທີ່ຈະອ່ານຈາກສະຖານທີ່ໃຫມ່.

CGM_putInstr
ການປຽບທຽບກັບ CGM_getInstr. ຟັງຊັນນີ້ buffers ຄໍາແນະນໍາ CGM ທີ່ຈະຂຽນເຖິງ
CGM ອ້າງອີງໂດຍ cgm_fd. ອີກເທື່ອຫນຶ່ງຜູ້ໃຊ້ບໍ່ຈໍາເປັນຕ້ອງກັງວົນກ່ຽວກັບຖານສອງ
ຮູບ​ແບບ​ຂອງ​ໄຟລ​໌​. ຂຽນຖືກປະຕິບັດຕາມລໍາດັບໃນຂະຫນາດບັນທຶກ ຂະຫນາດ as
ລະບຸໃນລະຫວ່າງການສ້າງ cgm_fd. ຂໍ້ຈໍາກັດຄວາມຍາວຂອງຂໍ້ມູນດຽວກັນທີ່ມີ
ວາງໃສ່ CGM_getInstr ຖືສໍາລັບ CGM_putInstr. ຖ້າຜູ້ໃຊ້ຕ້ອງການຜົນຜະລິດ
ຄໍາແນະນໍາທີ່ມີຄວາມຍາວຂໍ້ມູນຫຼາຍກວ່າ 32760 bytes ຫຼັງຈາກນັ້ນຂໍ້ມູນຈະຕ້ອງເປັນ
ແຍກອອກເປັນທ່ອນໄມ້ບໍ່ໃຫຍ່ກວ່າຂະໜາດນີ້. ຜູ້ໃຊ້ຕ້ອງຕັ້ງຄ່າ boolean ນຳ
ເພີ່ມເຕີມ ທຸງໃນ Instr. cgm_fd ຕ້ອງເປັນຕົວອະທິບາຍໄຟລ໌ທີ່ຖືກຕ້ອງເປີດສໍາລັບການຂຽນ.
ສໍາລັບລາຍລະອຽດຂອງທົ່ງນາຂອງ Instr ເບິ່ງໄຟລ໌ cgm_tools.h.

CGM_flushOutputInstr
Flush buffer ຜົນ​ຜະ​ລິດ​ທີ່​ໃຊ້​ໂດຍ CGM_putInstr ສໍາລັບໄຟລ໌ອ້າງອີງໂດຍ cgm_fdທີ່ຢູ່ ມັນ
ເປັນສິ່ງຈໍາເປັນເພື່ອລ້າງຢ່າງຈະແຈ້ງ buffer ຜົນຜະລິດທີ່ນໍາໃຊ້ໂດຍ CGM_putInstr ກ່ອນທີ່ຈະໄດ້
ໄຟລ໌ຖືກປິດຫຼືການເຂົ້າເຖິງແບບສຸ່ມແມ່ນດໍາເນີນການ. ຖ້າບໍ່ດັ່ງນັ້ນບໍ່ແມ່ນອົງປະກອບ CGM ທັງຫມົດ
ຕົວຈິງແລ້ວຈະໄດ້ຮັບການລາຍລັກອັກສອນ.

CGM_initMetaEdit
ເລີ່ມຕົ້ນ metafile ສໍາລັບການແກ້ໄຂ. ນີ້​ແມ່ນ​ຫຼັກ​ສູດ​ການ​ເລີ່ມ​ຕົ້ນ​ສໍາ​ລັບ​ການ​
ຂັ້ນຕອນການແກ້ໄຂລະດັບສູງກວ່າທີ່ມີຢູ່ໃນຊຸດນີ້: CGM_copyFrames,
CGM_deleteFrames, CGM_readFrames, CGM_moveFrames, CGM_writeFile, CGM_writeFrames,
ແລະ CGM_mergeFrames. ປົກກະຕິເຫຼົ່ານີ້ເຮັດວຽກພຽງແຕ່ຫນຶ່ງ metafile ໃນເວລາດຽວ (ຫນຶ່ງ
ມີ​ຊື່​ໃນ CGM_initMetaEdit. ຮຽກ​ຮ້ອງ​ກິດ​ຈະ​ກໍາ​ນີ້​ເປັນ​ຄັ້ງ​ທີ​ສອງ​ໂດຍ​ບໍ່​ມີ​ການ
ບັນທຶກການປ່ຽນແປງຢ່າງຈະແຈ້ງຈະມີຜົນຕໍ່ການໂຫຼດໄຟລ໌ໃໝ່ ແລະ
ຍົກເລີກການປ່ຽນແປງທັງໝົດໃນໄຟລ໌ກ່ອນໜ້ານີ້. CGM_initMetaEdit ແລະທັງ ໝົດ
ດໍາເນີນການແກ້ໄຂຫນ້າທີ່ ເຮັດໃຫ້ ການປ່ຽນແປງໄຟລ໌ສົ່ງຕົວຊີ້ໄປຫາ a
Directory ເປັນຄວາມສະດວກສະບາຍທີ່ອະນຸຍາດໃຫ້ຜູ້ໃຊ້ສາມາດກວດສອບສະຖານະຂອງໄຟລ໌.
ເນື້ອໃນຂອງໄດເລກະທໍລີເປັນສ່ວນຕົວ ແລະບໍ່ຄວນຖືກປ່ຽນແປງໂດຍຜູ້ໃຊ້. ກ
ຊຸດຂອງ macro ແມ່ນສະຫນອງໃຫ້ຢູ່ໃນ cgm_tools.h ຖືກນໍາໃຊ້ສໍາລັບການດຶງຂໍ້ມູນຂອງໄດເລກະທໍລີ
ເນື້ອໃນ. ຫມາຍ​ເຫດ​: ບໍ່ມີການປ່ຽນແປງຕົວຈິງກັບໄຟລ໌ດັດແກ້ເວັ້ນເສຍແຕ່ວ່າມັນແມ່ນ
ຂຽນທັບຢ່າງຈະແຈ້ງດ້ວຍອັນໃດນຶ່ງ CGM_writeFile or CGM_writeFrames.

CGM_termMetaEdit
ຢຸດເຊດຊັນການແກ້ໄຂເລີ່ມຕົ້ນດ້ວຍ CGM_initMetaEdit. ປົກກະຕິນີ້ຄວນ
ຈະຖືກເອີ້ນຫຼັງຈາກການປ່ຽນແປງການແກ້ໄຂໃດໆທີ່ຖືກບັນທຶກໄວ້, ຖ້າຕ້ອງການເພື່ອບັນທຶກພວກມັນ, ແລະ
ກ່ອນທີ່ຈະອອກຈາກເຊດຊັນການແກ້ໄຂ. CGM_termMetaEdit ປົດປ່ອຍຊັບພະຍາກອນທີ່ມີຄຸນຄ່າ.

CGM_copyFrames
ສໍາເນົາ num ກອບເລີ່ມຕົ້ນດ້ວຍ ການເລີ່ມຕົ້ນ ກັບກອບທີ່ແກ້ໄຂໂດຍ ເປົ້າ​ຫມາຍທີ່ຢູ່ ຖ້າຫາກວ່າ ເປົ້າ​ຫມາຍ is
occupied ແລ້ວຫຼັງຈາກນັ້ນກອບແຫຼ່ງແມ່ນ inserted ໃນສະຖານທີ່ຂອງຕົນໃນຂະນະທີ່ເປົ້າຫມາຍ
ກອບ, ແລະກອບດໍາເນີນການທັງຫມົດ, ແມ່ນກ້າວຫນ້າທາງດ້ານ. CGM_copy ດໍາເນີນການກ່ຽວກັບໄຟລ໌
ເລີ່ມຕົ້ນໂດຍ CGM_initMetaEdit (ໄຟລ​໌​ແກ້​ໄຂ​)​. ໃນ​ການ​ສໍາ​ເລັດ​ຜົນ​ສໍາ​ເລັດ​ຕົວ​ຊີ້​
ໄປຫາໄດເລກະທໍລີປະຈຸບັນຖືກສົ່ງຄືນ. ດ້ວຍຄວາມຜິດພາດ, ຕົວຊີ້ NULL ຖືກສົ່ງຄືນ.

CGM_deleteFrames
ລົບ num ກອບຈາກໄຟລ໌ດັດແກ້ເລີ່ມຕົ້ນດ້ວຍກອບ ການເລີ່ມຕົ້ນ. ສຳເລັດແລ້ວ
ສໍາເລັດຕົວຊີ້ໄປຫາໄດເລກະທໍລີປະຈຸບັນຈະຖືກສົ່ງຄືນ. ເກີດຄວາມຜິດພາດຕົວຊີ້ NULL
ຖືກສົ່ງຄືນ.

CGM_mergeFrames
ຂຽນທັບເນື້ອໃນຂອງກອບທີ່ແກ້ໄຂ ທາງລຸ່ມ ກັບສະຫະພັນຂອງກອບທີ່
ສະຖານທີ່ ທາງລຸ່ມ ແລະກອບຢູ່ໃນສະຖານທີ່ top. ຜົນກະທົບຂອງຄໍາສັ່ງນີ້ແມ່ນ
ເທົ່າກັບການແຕ້ມຮູບ top ກອບຢູ່ເທິງສຸດຂອງ ທາງລຸ່ມ ກອບ. ມັນບໍ່ແມ່ນສະຫະພັນ
ໃນຄວາມຫມາຍທີ່ແທ້ຈິງຂອງຄໍາສັບ. ເມື່ອສໍາເລັດສົບຜົນສໍາເລັດ, ຕົວຊີ້ໄປຫາປະຈຸບັນ
ໄດເລກະທໍລີຖືກສົ່ງຄືນ. ດ້ວຍຄວາມຜິດພາດ, ຕົວຊີ້ NULL ຖືກສົ່ງຄືນ.

CGM_moveFrames
ຍ້າຍຕັນຂອງ num ກອບຈາກໄຟລ໌ດັດແກ້ເລີ່ມຕົ້ນດ້ວຍກອບ ການເລີ່ມຕົ້ນ ການ
ຕໍາແຫນ່ງທີ່ຄອບຄອງໂດຍກອບ ເປົ້າ​ຫມາຍ ເມື່ອສໍາເລັດສົບຜົນສໍາເລັດ, ຕົວຊີ້ໄປຫາປະຈຸບັນ
ໄດເລກະທໍລີຖືກສົ່ງຄືນ. ດ້ວຍຄວາມຜິດພາດ, ຕົວຊີ້ NULL ຖືກສົ່ງຄືນ.

CGM_readFrames
ອ່ານ num ກອບຈາກ metafile ເອກະສານ ເລີ່ມຕົ້ນດ້ວຍກອບ ການເລີ່ມຕົ້ນ. ໃສ່ກອບຢູ່
ທີ່ຢູ່ ເປົ້າ​ຫມາຍ ໃນ​ໄຟລ​໌​ແກ້​ໄຂ​. ເມື່ອສໍາເລັດສົບຜົນສໍາເລັດ, ຕົວຊີ້ໄປຫາປະຈຸບັນ
ໄດເລກະທໍລີຖືກສົ່ງຄືນ. ດ້ວຍຄວາມຜິດພາດ, ຕົວຊີ້ NULL ຖືກສົ່ງຄືນ.

CGM_validCGM
ກໍານົດວ່າໄຟລ໌ເປັນ NCAR CGM ທີ່ຖືກຕ້ອງຫຼືບໍ່. ຟັງຊັນນີ້ປະຕິບັດຈໍານວນຫນ້ອຍ
ການວິນິດໄສແບບງ່າຍໆໃນຄວາມພະຍາຍາມເພື່ອກໍານົດວ່າໄຟລ໌ທີ່ໃຫ້ຢູ່ໃນ NCAR
ຮູບແບບ CGM. ການ​ທົດ​ສອບ​ທີ່​ໄດ້​ປະ​ຕິ​ບັດ​ແມ່ນ​ບໍ່​ເຄັ່ງ​ຄັດ​ແລະ​ມັນ​ເປັນ​ທີ່​ຄິດ​ໄດ້​ວ່າ​
ຂໍ້ມູນທີ່ຖືກດຶງມາບໍ່ຖືກຕ້ອງ. ຜົນຕອບແທນຂອງ 1 ສະແດງເຖິງ NCAR CGM ທີ່ຖືກຕ້ອງ. ກ
ກັບຄືນຂອງ 0 ສະແດງໃຫ້ເຫັນວ່າໄຟລ໌ບໍ່ແມ່ນ NCAR CGM. ຜົນຕອບແທນຂອງ -1 ສະແດງເຖິງຄວາມຜິດພາດ
ເກີດຂຶ້ນແລະຕົວແປທົ່ວໂລກ 'errno' ຖືກກໍານົດຕາມຄວາມເຫມາະສົມ.

CGM_writeFile
ຂຽນເນື້ອໃນທັງຫມົດຂອງໄຟລ໌ດັດແກ້ປະຈຸບັນເພື່ອ ເອກະສານ. CGM_writeFile ກັບຄືນມາ
ຈຳນວນເຕັມຂອງຄວາມສຳເລັດ ແລະຕົວເລກລົບຕໍ່ຄວາມລົ້ມເຫລວ.

CGM_writeFrames
ຂຽນບລັອກຂອງ num ກອບເລີ່ມຕົ້ນດ້ວຍກອບ ການເລີ່ມຕົ້ນ to ເອກະສານ. ກອບແຫຼ່ງ
ມາຈາກໄຟລ໌ແກ້ໄຂ. ຫມາຍເຫດ: ກອບ CGM ແມ່ນບັນຈຸຢູ່ໃນຫໍ່ທີ່ປະກອບດ້ວຍ
ຄ. ສ ຕົວຂັ້ນ ອົງປະກອບ. ໄຟລ໌ທີ່ສ້າງຂຶ້ນໂດຍ CGM_writeFrames ຈະໃຊ້ wrapper
ສະໜອງໃຫ້ໂດຍໄຟລ໌ແກ້ໄຂປັດຈຸບັນ. ດັ່ງນັ້ນຖ້າຫາກວ່າໄຟລ໌ ຟູ ປະກອບດ້ວຍ n ກອບທີ່ເປັນ
ອ່ານ ເຂົ້າໄປໃນເຊດຊັນການແກ້ໄຂດ້ວຍໄຟລ໌ ກູ ແລະຫຼັງຈາກນັ້ນກອບດຽວກັນເຫຼົ່ານີ້ຖືກຂຽນ
ອອກໄປຫາໄຟລ໌ zoid, zoid ອາດຈະ ຫຼືອາດຈະບໍ່ຄືກັນກັບຕົ້ນສະບັບ ຟູ.
CGM_writeFrames ສົ່ງຄ່າຈຳນວນເຕັມທີ່ສຳເລັດ ແລະເປັນຕົວເລກລົບຢູ່ເທິງ
ຄວາມລົ້ມເຫຼວ.

CGM_appendFrames
ຕື່ມຂໍ້ມູນໃສ່ຕັນຂອງ num ກອບເລີ່ມຕົ້ນດ້ວຍກອບ ການເລີ່ມຕົ້ນ to ເອກະສານ. ເອກະສານ ຕ້ອງແລ້ວ
ມີຢູ່ແລະເປັນ NCAR CGM ທີ່ຖືກຕ້ອງ. CGM_appendFrames ສົ່ງຄືນຈຳນວນເຕັມທີ່ປະສົບຜົນສຳເລັດ
ແລະຕົວເລກລົບກ່ຽວກັບຄວາມລົ້ມເຫລວ.

ໃຊ້ cgmNCARG ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net