Skip to content

Commit 896f8ec

Browse files
authored
tiny doc fixes
1 parent 8096a8c commit 896f8ec

File tree

1 file changed

+38
-49
lines changed

1 file changed

+38
-49
lines changed

DecoderSDK/CFHDDecoder.cpp

Lines changed: 38 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -188,10 +188,10 @@ CFHD_OpenDecoder(CFHD_DecoderRef *decoderRefOut,
188188
An opaque reference to a decoder created by a call to @ref CFHD_OpenDecoder.
189189
190190
@param samplePtr
191-
The memory address of a CineForm compressed sample
191+
The memory address of a CineForm compressed sample.
192192
193193
@param sampleSize
194-
The size of a CineForm compressed sample
194+
The size of a CineForm compressed sample.
195195
196196
@param outputFormatArray
197197
Pointer to a preallocated array of type CFHD_PixelFormat.
@@ -200,7 +200,7 @@ CFHD_OpenDecoder(CFHD_DecoderRef *decoderRefOut,
200200
Number elements in the preallocated array of type CFHD_PixelFormat.
201201
202202
@param actualOutputFormatCountOut
203-
Location to return the number of recommended formats.
203+
Location to return the number of recommended formats.
204204
205205
@return Returns a CFHD error code.
206206
*/
@@ -245,19 +245,19 @@ CFHD_GetOutputFormats(CFHD_DecoderRef decoderRef,
245245
An opaque reference to a decoder created by a call to @ref CFHD_OpenDecoder.
246246
247247
@param samplePtr
248-
The memory address of a CineForm compressed sample
248+
The memory address of a CineForm compressed sample.
249249
250250
@param sampleSize
251-
The size of a CineForm compressed sample
251+
The size of a CineForm compressed sample.
252252
253253
@param tag
254-
The request the desired data.
254+
The request the desired data.
255255
256256
@param value
257-
pointer to an buffer that holds the return value.
257+
Pointer to an buffer that holds the return value.
258258
259259
@param buffer_size
260-
size of the buffer for the return value.
260+
Size of the buffer for the return value.
261261
262262
@return Returns a CFHD error code.
263263
*/
@@ -344,9 +344,9 @@ CFHD_GetSampleInfo( CFHD_DecoderRef decoderRef,
344344
initializing the decoder.
345345
346346
@param sampleSize
347-
Normally this size of the sample in bytes, if you intend to go on to decode the frame.
347+
Normally this size of the sample in bytes, if you intend to go on to decode the frame.
348348
However, if you was only initializing a decode, and wish to reduce disk overhead,
349-
you can set the size to a little as 512, as that is sufficient to pass all the need
349+
you can set the size to a little as 512, as that is sufficient to pass all the need
350350
information from the sample header.
351351
352352
@param actualWidthOut
@@ -427,16 +427,16 @@ CFHD_PrepareToDecode(CFHD_DecoderRef decoderRef,
427427
@brief Parse the header in the encoded video sample. OBSOLETED by CFHD_GetSampleInfo()
428428
429429
@description The sample header is parsed to obtain information about the
430-
video sample without decoding the video sample.
430+
video sample without decoding the video sample.
431431
432432
@param samplePtr
433-
The memory address of a CineForm compressed sample
433+
The memory address of a CineForm compressed sample.
434434
435435
@param sampleSize
436-
The size of a CineForm compressed sample
436+
The size of a CineForm compressed sample.
437437
438438
@param sampleHeader
439-
The address of a pre-allocated structure of type CFHD_SampleHeader
439+
The address of a pre-allocated structure of type CFHD_SampleHeader.
440440
441441
*/
442442
CFHDDECODER_API CFHD_Error
@@ -510,20 +510,20 @@ CFHD_ParseSampleHeader(void *samplePtr,
510510
/*!
511511
@function CFHD_GetPixelSize
512512
513-
@brief Return the size of the specified pixel format in bytes.
513+
@brief Return the size of the specified pixel format in bytes.
514514
515-
@description Return the size of a pixel in byte is it uniquely
515+
@description Return the size of a pixel in byte is it uniquely
516516
addressable. Note that the pixel size is not defined for some
517517
image formats such as v210. This routine returns zero for pixel
518518
formats that do not have a size that is an integer number of bytes.
519519
When the pixel size is not well-defined, it cannot be used to
520520
compute the pitch of the image rows. See @ref CFHD_GetImagePitch.
521521
522522
@param pixelFormat
523-
CFHD_PixelFormat of the decoding pixel type
523+
CFHD_PixelFormat of the decoding pixel type.
524524
525525
@param pixelSizeOut
526-
pointer to return the pixel size
526+
Pointer to return the pixel size.
527527
528528
@return Returns a CFHD error code.
529529
*/
@@ -607,17 +607,17 @@ CFHD_GetPixelSize(CFHD_PixelFormat pixelFormat, uint32_t *pixelSizeOut)
607607
608608
@brief Return the allocated length of each image row in bytes.
609609
610-
@description This routine must be used to determine the pitch for
610+
@description This routine must be used to determine the pitch for
611611
pixel formats such as v210 where the pixel size is not defined.
612612
613613
@param imageWidth
614-
width of the image.
614+
Width of the image.
615615
616616
@param pixelFormat
617-
CFHD_PixelFormat of the decoding pixel type
617+
CFHD_PixelFormat of the decoding pixel type.
618618
619619
@param imagePitchOut
620-
pointer to return the rowsize/pitch in bytes
620+
Pointer to return the rowsize/pitch in bytes.
621621
622622
@return Returns a CFHD error code.
623623
*/
@@ -637,28 +637,28 @@ CFHD_GetImagePitch(uint32_t imageWidth, CFHD_PixelFormat pixelFormat, int32_t *i
637637
/*!
638638
@function CFHD_GetImageSize
639639
640-
@brief Return the size of an image in bytes.
640+
@brief Return the size of an image in bytes.
641641
642642
@description This image size returned by this routine can be used to allocate a
643643
buffer for a decoded 2D or 3D image.
644644
645645
@param imageWidth
646-
width of the image.
646+
Width of the image.
647647
648648
@param imageHeight
649-
Height of the image. In the case of a 3D image, this is the height of a single eye.
649+
Height of the image. In the case of a 3D image, this is the height of a single eye.
650650
651651
@param pixelFormat
652-
CFHD_PixelFormat of the decoding pixel type
652+
CFHD_PixelFormat of the decoding pixel type.
653653
654654
@param videoselect
655-
CFHD_VideoSelect type to specifty if you are decoding left/right or both eyes
655+
CFHD_VideoSelect type to specify if you are decoding left/right or both eyes.
656656
657657
@param stereotype
658-
CFHD_Stereo3DType type to specifty 3D format if decoding both eyes.
658+
CFHD_Stereo3DType type to specify 3D format if decoding both eyes.
659659
660660
@param imageSizeOut
661-
pointer to return the image size in bytes
661+
Pointer to return the image size in bytes.
662662
663663
@return Returns a CFHD error code.
664664
*/
@@ -741,9 +741,9 @@ CFHD_DecodeSample(CFHD_DecoderRef decoderRef,
741741
{
742742
int len = length;
743743
if(outputPitch > 0)
744-
test_mem[len - 1] = 0;
744+
test_mem[len - 1] = 0;
745745
if(outputPitch < 0)
746-
test_mem[-(len + outputPitch)] = 0;
746+
test_mem[-(len + outputPitch)] = 0;
747747
}
748748
}
749749
catch (...)
@@ -879,7 +879,7 @@ void make_crc_table(void)
879879
crc() routine below)). */
880880

881881
uint32_t update_crc(uint32_t crc, unsigned char *buf,
882-
int len)
882+
int len)
883883
{
884884
uint32_t c = crc;
885885
int n;
@@ -963,8 +963,6 @@ void GenerateLUTfile(unsigned int crc, float *LUT, int size, char *displayname)
963963
CFLKhdr.input_curve = CURVE_LOG_90;// CURVE_TYPE input to the LUT
964964
CFLKhdr.output_curve = CURVE_GAMMA_2pt2;// CURVE_TYPE output from the LUT
965965

966-
967-
968966
char drive[260], dir[260], fname[260], ext[64];
969967

970968
_splitpath(displayname, drive, dir, fname, ext);
@@ -991,10 +989,8 @@ void GenerateLUTfile(unsigned int crc, float *LUT, int size, char *displayname)
991989
if((i&7)==0)
992990
fwrite(space,1,strlen(space),fp);
993991

994-
995992
sprintf(hexval,"%02X%02X%02X%02X", ptr[0], ptr[1], ptr[2], ptr[3]);
996993
fwrite(hexval,1,8,fp);
997-
998994
}
999995

1000996

@@ -1053,7 +1049,6 @@ unsigned int ValidateLookGenCRC(char* path)
10531049
pos+=5;
10541050
LUTfound = true;
10551051
break;
1056-
10571052
}
10581053
pos++;
10591054
} while(pos < len-5);
@@ -1120,8 +1115,6 @@ unsigned int ValidateLookGenCRC(char* path)
11201115

11211116
//printf("%s\n",&buf[pos+j]);
11221117

1123-
1124-
11251118
DATAfound = true;
11261119
break;
11271120

@@ -1188,8 +1181,6 @@ unsigned int ValidateLookGenCRC(char* path)
11881181
} while(pos < len-16 && !finished);
11891182
}
11901183

1191-
1192-
11931184
// printf("len = %d\n", len);
11941185
}
11951186
while(len > 0 && !finished);
@@ -1217,7 +1208,7 @@ unsigned int ValidateLookGenCRC(char* path)
12171208
return crc;
12181209
}
12191210

1220-
#endif
1211+
#endif
12211212

12221213

12231214
/*!
@@ -1226,7 +1217,7 @@ unsigned int ValidateLookGenCRC(char* path)
12261217
@brief Recursively add active metadata for the decoder to use.
12271218
12281219
@description Decoder will use the active metadata store in the sample, or in
1229-
the color database or overrided by the Tags added by this function. If you
1220+
the color database or override by the Tags added by this function. If you
12301221
want the decoder to use the original camera data with a few change, initialize
12311222
the metadata engine with @ref CFHD_InitSampleMetadata with the track set to
12321223
METADATATYPE_ORIGINAL. Then call CFHD_SetActiveMetadata we the tag you want it
@@ -1280,7 +1271,7 @@ CFHD_SetActiveMetadata( CFHD_DecoderRef decoderRef,
12801271
//if(metadata->m_overrideSize == 0)
12811272
{
12821273
if(metadata->m_metadataTrack & METADATAFLAG_MODIFIED)
1283-
{
1274+
{
12841275
int data = 1;
12851276
int typesizebytes = ('H'<<24)|4;
12861277

@@ -1290,7 +1281,7 @@ CFHD_SetActiveMetadata( CFHD_DecoderRef decoderRef,
12901281
metadata->AddMetaData(TAG_IGNORE_DATABASE, typesizebytes, (void *)&data);
12911282
}
12921283
else
1293-
{
1284+
{
12941285
int data = 1;
12951286
int typesizebytes = ('H'<<24)|4;
12961287

@@ -1388,7 +1379,6 @@ CFHD_SetActiveMetadata( CFHD_DecoderRef decoderRef,
13881379
_makepath(filename, NULL, NULL, fname, ext);
13891380
#endif
13901381

1391-
13921382
if(strlen(filename) < 40)
13931383
{
13941384
typesizebytes = ('c'<<24)|39;
@@ -1480,7 +1470,6 @@ CFHD_ClearActiveMetadata( CFHD_DecoderRef decoderRef,
14801470
}
14811471

14821472

1483-
14841473
/*!
14851474
@function CFHD_GetThumbnail
14861475
@@ -1500,7 +1489,7 @@ CFHD_ClearActiveMetadata( CFHD_DecoderRef decoderRef,
15001489
Size of the encoded sample.
15011490
15021491
@param outputBuffer
1503-
Buffer that will receive the thumbnail of size 1/8 x 1/8 the original frame.
1492+
Buffer that will receive the thumbnail of size 1/8 x 1/8 the original frame.
15041493
15051494
@param outputBufferSize
15061495
Size must be at least ((w+7)/8) * ((h+7)/8) * 4 for 10-bit RGB format.
@@ -1582,7 +1571,7 @@ CFHD_CreateImageDeveloper(CFHD_DecoderRef decoderRef,
15821571
uint32_t imageHeight,
15831572
uint32_t sourceVideoChannels,
15841573
CFHD_PixelFormat pixelFormatSrc,
1585-
CFHD_PixelFormat pixelFormatDst) //1 or 2 for 3D double high stacked
1574+
CFHD_PixelFormat pixelFormatDst) //1 or 2 for 3D double high stacked
15861575
{
15871576
CFHD_Error errorCode = CFHD_ERROR_OKAY;
15881577

0 commit comments

Comments
 (0)