git.sesse.net Git - mlt/blob - src/framework/mlt_frame.c

   1 /*
   2  * mlt_frame.c -- interface for all frame classes
   3  * Copyright (C) 2003-2004 Ushodaya Enterprises Limited
   4  * Author: Charles Yates <charles.yates@pandora.be>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software Foundation,
  18  * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  19  */
  20
  21 #include "config.h"
  22 #include "mlt_frame.h"
  23 #include <stdio.h>
  24 #include <stdlib.h>
  25 #include <string.h>
  26
  27 typedef struct
  28 {
  29         mlt_image_format vfmt;
  30         int width;
  31         int height;
  32         uint8_t *image;
  33         uint8_t *alpha;
  34         mlt_audio_format afmt;
  35         int16_t *audio;
  36 }
  37 frame_test;
  38
  39 static frame_test test_card = { mlt_image_none, 0, 0, NULL, NULL, mlt_audio_none, NULL };
  40
  41 /** Constructor for a frame.
  42 */
  43
  44 mlt_frame mlt_frame_init( )
  45 {
  46         // Allocate a frame
  47         mlt_frame this = calloc( sizeof( struct mlt_frame_s ), 1 );
  48
  49         if ( this != NULL )
  50         {
  51                 // Initialise the properties
  52                 mlt_properties properties = &this->parent;
  53                 mlt_properties_init( properties, this );
  54
  55                 // Set default properties on the frame
  56                 mlt_properties_set_timecode( properties, "timecode", 0.0 );
  57                 mlt_properties_set_data( properties, "image", NULL, 0, NULL, NULL );
  58                 mlt_properties_set_int( properties, "width", 720 );
  59                 mlt_properties_set_int( properties, "height", 576 );
  60                 mlt_properties_set_double( properties, "aspect_ratio", 4.0 / 3.0 );
  61                 mlt_properties_set_data( properties, "audio", NULL, 0, NULL, NULL );
  62                 mlt_properties_set_data( properties, "alpha", NULL, 0, NULL, NULL );
  63         }
  64         return this;
  65 }
  66
  67 /** Fetch the frames properties.
  68 */
  69
  70 mlt_properties mlt_frame_properties( mlt_frame this )
  71 {
  72         return &this->parent;
  73 }
  74
  75 /** Check if we have a way to derive something other than a test card.
  76 */
  77
  78 int mlt_frame_is_test_card( mlt_frame this )
  79 {
  80         return this->stack_get_image_size == 0;
  81 }
  82
  83 /** Get the aspect ratio of the frame.
  84 */
  85
  86 double mlt_frame_get_aspect_ratio( mlt_frame this )
  87 {
  88         mlt_properties properties = mlt_frame_properties( this );
  89         return mlt_properties_get_double( properties, "aspect_ratio" );
  90 }
  91
  92 /** Set the aspect ratio of the frame.
  93 */
  94
  95 int mlt_frame_set_aspect_ratio( mlt_frame this, double value )
  96 {
  97         mlt_properties properties = mlt_frame_properties( this );
  98         return mlt_properties_set_double( properties, "aspect_ratio", value );
  99 }
 100
 101 /** Get the timecode of this frame.
 102 */
 103
 104 mlt_timecode mlt_frame_get_timecode( mlt_frame this )
 105 {
 106         mlt_properties properties = mlt_frame_properties( this );
 107         return mlt_properties_get_timecode( properties, "timecode" );
 108 }
 109
 110 /** Set the timecode of this frame.
 111 */
 112
 113 int mlt_frame_set_timecode( mlt_frame this, mlt_timecode value )
 114 {
 115         mlt_properties properties = mlt_frame_properties( this );
 116         return mlt_properties_set_timecode( properties, "timecode", value );
 117 }
 118
 119 /** Stack a get_image callback.
 120 */
 121
 122 int mlt_frame_push_get_image( mlt_frame this, mlt_get_image get_image )
 123 {
 124         int ret = this->stack_get_image_size >= 10;
 125         if ( ret == 0 )
 126                 this->stack_get_image[ this->stack_get_image_size ++ ] = get_image;
 127         return ret;
 128 }
 129
 130 /** Pop a get_image callback.
 131 */
 132
 133 mlt_get_image mlt_frame_pop_get_image( mlt_frame this )
 134 {
 135         mlt_get_image result = NULL;
 136         if ( this->stack_get_image_size > 0 )
 137                 result = this->stack_get_image[ -- this->stack_get_image_size ];
 138         return result;
 139 }
 140
 141 /** Push a frame.
 142 */
 143
 144 int mlt_frame_push_frame( mlt_frame this, mlt_frame that )
 145 {
 146         int ret = this->stack_frame_size >= 10;
 147         if ( ret == 0 )
 148                 this->stack_frame[ this->stack_frame_size ++ ] = that;
 149         return ret;
 150 }
 151
 152 /** Pop a frame.
 153 */
 154
 155 mlt_frame mlt_frame_pop_frame( mlt_frame this )
 156 {
 157         mlt_frame result = NULL;
 158         if ( this->stack_frame_size > 0 )
 159                 result = this->stack_frame[ -- this->stack_frame_size ];
 160         return result;
 161 }
 162
 163 int mlt_frame_get_image( mlt_frame this, uint8_t **buffer, mlt_image_format *format, int *width, int *height, int writable )
 164 {
 165         mlt_properties properties = mlt_frame_properties( this );
 166         mlt_get_image get_image = mlt_frame_pop_get_image( this );
 167
 168         if ( get_image != NULL )
 169         {
 170                 return get_image( this, buffer, format, width, height, writable );
 171         }
 172         else if ( mlt_properties_get_data( properties, "image", NULL ) != NULL )
 173         {
 174                 *format = mlt_image_yuv422;
 175                 *buffer = mlt_properties_get_data( properties, "image", NULL );
 176                 *width = mlt_properties_get_int( properties, "width" );
 177                 *height = mlt_properties_get_int( properties, "height" );
 178         }
 179         else
 180         {
 181                 if ( test_card.vfmt != *format )
 182                 {
 183                         uint8_t *p;
 184                         uint8_t *q;
 185
 186                         test_card.vfmt = *format;
 187                         test_card.width = *width == 0 ? 720 : *width;
 188                         test_card.height = *height == 0 ? 576 : *height;
 189
 190                         switch( *format )
 191                         {
 192                                 case mlt_image_none:
 193                                         break;
 194                                 case mlt_image_rgb24:
 195                                         test_card.image = realloc( test_card.image, test_card.width * test_card.height * 3 );
 196                                         memset( test_card.image, 255, test_card.width * test_card.height * 3 );
 197                                         break;
 198                                 case mlt_image_rgb24a:
 199                                         test_card.image = realloc( test_card.image, test_card.width * test_card.height * 4 );
 200                                         memset( test_card.image, 255, test_card.width * test_card.height * 4 );
 201                                         break;
 202                                 case mlt_image_yuv422:
 203                                         test_card.image = realloc( test_card.image, test_card.width * test_card.height * 2 );
 204                                         p = test_card.image;
 205                                         q = test_card.image + test_card.width * test_card.height * 2;
 206                                         while ( p != q )
 207                                         {
 208                                                 *p ++ = 255;
 209                                                 *p ++ = 128;
 210                                         }
 211                                         break;
 212                                 case mlt_image_yuv420p:
 213                                         test_card.image = realloc( test_card.image, test_card.width * test_card.height * 3 / 2 );
 214                                         memset( test_card.image, 255, test_card.width * test_card.height * 3 / 2 );
 215                                         break;
 216                         }
 217                 }
 218
 219                 *width = test_card.width;
 220                 *height = test_card.height;
 221                 *buffer = test_card.image;
 222         }
 223
 224         return 0;
 225 }
 226
 227 uint8_t *mlt_frame_get_alpha_mask( mlt_frame this )
 228 {
 229         if ( this->get_alpha_mask != NULL )
 230                 return this->get_alpha_mask( this );
 231         return test_card.alpha;
 232 }
 233
 234 int mlt_frame_get_audio( mlt_frame this, int16_t **buffer, mlt_audio_format *format, int *frequency, int *channels, int *samples )
 235 {
 236         if ( this->get_audio != NULL )
 237         {
 238                 return this->get_audio( this, buffer, format, frequency, channels, samples );
 239         }
 240         else
 241         {
 242                 if ( test_card.afmt != *format )
 243                 {
 244                         test_card.afmt = *format;
 245                         test_card.audio = realloc( test_card.audio, 1920 * 2 * sizeof( int16_t ) );
 246                         memset( test_card.audio, 0, 1920 * 2 * sizeof( int16_t ) );
 247                 }
 248
 249                 *buffer = test_card.audio;
 250                 *frequency = 48000;
 251                 *channels = 2;
 252                 *samples = 1920;
 253         }
 254         return 0;
 255 }
 256
 257 void mlt_frame_close( mlt_frame this )
 258 {
 259         mlt_frame frame = mlt_frame_pop_frame( this );
 260
 261         while ( frame != NULL )
 262         {
 263                 mlt_frame_close( frame);
 264                 frame = mlt_frame_pop_frame( this );
 265         }
 266
 267         mlt_properties_close( &this->parent );
 268
 269         free( this );
 270 }
 271
 272 /***** convenience functions *****/
 273 #define RGB2YUV(r, g, b, y, u, v)\
 274   y = (306*r + 601*g + 117*b)  >> 10;\
 275   u = ((-172*r - 340*g + 512*b) >> 10)  + 128;\
 276   v = ((512*r - 429*g - 83*b) >> 10) + 128;\
 277   y = y < 0 ? 0 : y;\
 278   u = u < 0 ? 0 : u;\
 279   v = v < 0 ? 0 : v;\
 280   y = y > 255 ? 255 : y;\
 281   u = u > 255 ? 255 : u;\
 282   v = v > 255 ? 255 : v
 283
 284 int mlt_convert_rgb24a_to_yuv422( uint8_t *rgba, int width, int height, int stride, uint8_t *yuv, uint8_t *alpha )
 285 {
 286         int ret = 0;
 287         register int y0, y1, u0, u1, v0, v1;
 288         register int r, g, b;
 289         register uint8_t *d = yuv;
 290         register int i, j;
 291
 292         for ( i = 0; i < height; i++ )
 293         {
 294                 register uint8_t *s = rgba + ( stride * i );
 295                 for ( j = 0; j < ( width / 2 ); j++ )
 296                 {
 297                         r = *s++;
 298                         g = *s++;
 299                         b = *s++;
 300                         *alpha++ = *s++;
 301                         RGB2YUV (r, g, b, y0, u0 , v0);
 302                         r = *s++;
 303                         g = *s++;
 304                         b = *s++;
 305                         *alpha++ = *s++;
 306                         RGB2YUV (r, g, b, y1, u1 , v1);
 307                         *d++ = y0;
 308                         *d++ = (u0+u1) >> 1;
 309                         *d++ = y1;
 310                         *d++ = (v0+v1) >> 1;
 311                 }
 312                 if ( width % 2 )
 313                 {
 314                         r = *s++;
 315                         g = *s++;
 316                         b = *s++;
 317                         *alpha++ = *s++;
 318                         RGB2YUV (r, g, b, y0, u0 , v0);
 319                         *d++ = y0;
 320                         *d++ = u0;
 321                 }
 322         }
 323         return ret;
 324 }
 325
 326 int mlt_convert_rgb24_to_yuv422( uint8_t *rgb, int width, int height, int stride, uint8_t *yuv )
 327 {
 328         int ret = 0;
 329         register int y0, y1, u0, u1, v0, v1;
 330         register int r, g, b;
 331         register uint8_t *d = yuv;
 332         register int i, j;
 333
 334         for ( i = 0; i < height; i++ )
 335         {
 336                 register uint8_t *s = rgb + ( stride * i );
 337                 for ( j = 0; j < ( width / 2 ); j++ )
 338                 {
 339                         r = *s++;
 340                         g = *s++;
 341                         b = *s++;
 342                         RGB2YUV (r, g, b, y0, u0 , v0);
 343                         r = *s++;
 344                         g = *s++;
 345                         b = *s++;
 346                         RGB2YUV (r, g, b, y1, u1 , v1);
 347                         *d++ = y0;
 348                         *d++ = (u0+u1) >> 1;
 349                         *d++ = y1;
 350                         *d++ = (v0+v1) >> 1;
 351                 }
 352                 if ( width % 2 )
 353                 {
 354                         r = *s++;
 355                         g = *s++;
 356                         b = *s++;
 357                         RGB2YUV (r, g, b, y0, u0 , v0);
 358                         *d++ = y0;
 359                         *d++ = u0;
 360                 }
 361         }
 362         return ret;
 363 }
 364
 365 int mlt_frame_composite_yuv( mlt_frame this, mlt_frame that, int x, int y, float weight )
 366 {
 367         int ret = 0;
 368         int x_start = 0;
 369         int width_src, height_src;
 370         int width_dest, height_dest;
 371         mlt_image_format format_src, format_dest;
 372         uint8_t *p_src, *p_dest;
 373         int x_end;
 374         int i, j;
 375         int stride_src;
 376         int stride_dest;
 377
 378         format_src = mlt_image_yuv422;
 379         format_dest = mlt_image_yuv422;
 380
 381         mlt_frame_get_image( this, &p_dest, &format_dest, &width_dest, &height_dest, 1 /* writable */ );
 382         mlt_frame_get_image( that, &p_src, &format_src, &width_src, &height_src, 0 /* writable */ );
 383
 384         x_end = width_src;
 385
 386         stride_src = width_src * 2;
 387         stride_dest = width_dest * 2;
 388         uint8_t *lower = p_dest;
 389         uint8_t *upper = p_dest + height_dest * stride_dest;
 390
 391         p_dest += ( y * stride_dest ) + ( x * 2 );
 392
 393         if ( x < 0 )
 394         {
 395                 x_start = -x;
 396                 x_end += x_start;
 397         }
 398
 399         uint8_t *z = mlt_frame_get_alpha_mask( that );
 400
 401         for ( i = 0; i < height_src; i++ )
 402         {
 403                 uint8_t *p = p_src;
 404                 uint8_t *q = p_dest;
 405                 uint8_t *o = p_dest;
 406
 407                 for ( j = 0; j < width_src; j ++ )
 408                 {
 409                         if ( q >= lower && q < upper && j >= x_start && j < x_end )
 410                         {
 411                                 uint8_t y = *p ++;
 412                                 uint8_t uv = *p ++;
 413                                 uint8_t a = ( z == NULL ) ? 255 : *z ++;
 414                                 float value = ( weight * ( float ) a / 255.0 );
 415                                 *o ++ = (uint8_t)( y * value + *q++ * ( 1 - value ) );
 416                                 *o ++ = (uint8_t)( uv * value + *q++ * ( 1 - value ) );
 417                         }
 418                         else
 419                         {
 420                                 p += 2;
 421                                 o += 2;
 422                                 q += 2;
 423                                 if ( z != NULL )
 424                                         z += 1;
 425                         }
 426                 }
 427
 428                 p_src += stride_src;
 429                 p_dest += stride_dest;
 430         }
 431
 432         return ret;
 433 }
 434
 435 void *memfill( void *dst, void *src, int l, int elements )
 436 {
 437         int i = 0;
 438         for ( i = 0; i < elements; i ++ )
 439                 dst = memcpy( dst, src, l ) + l;
 440         return dst;
 441 }
 442
 443 void mlt_resize_yuv422( uint8_t *output, int owidth, int oheight, uint8_t *input, int iwidth, int iheight )
 444 {
 445         // Calculate strides
 446         int istride = iwidth * 2;
 447         int ostride = owidth * 2;
 448
 449         // Coordinates (0,0 is middle of output)
 450         int y;
 451
 452         // Calculate ranges
 453         int out_x_range = owidth / 2;
 454         int out_y_range = oheight / 2;
 455         int in_x_range = iwidth / 2 < out_x_range ? iwidth / 2 : out_x_range;
 456         int in_y_range = iheight / 2 < out_y_range ? iheight / 2 : out_y_range;
 457
 458         // Output pointers
 459         uint8_t *out_line = output;
 460         uint8_t *out_ptr;
 461
 462         // Calculate a middle and possibly invalid pointer in the input
 463         uint8_t *in_middle = input + istride * ( iheight / 2 ) + ( iwidth / 2 ) * 2;
 464         int in_line = - in_y_range * istride - in_x_range * 2;
 465
 466         uint8_t black[ 2 ] = { 16, 128 };
 467
 468         // Loop for the entirety of our output height.
 469         for ( y = - out_y_range; y < out_y_range ; y ++ )
 470         {
 471         // Start at the beginning of the line
 472         out_ptr = out_line;
 473
 474                 if ( abs( y ) < iheight / 2 )
 475                 {
 476                         // Fill the outer part with black
 477                         out_ptr = memfill( out_ptr, black, 2, out_x_range - in_x_range );
 478
 479                 // We're in the input range for this row.
 480                         memcpy( out_ptr, in_middle + in_line, 4 * in_x_range );
 481                         out_ptr += 4 * in_x_range;
 482
 483                         // Fill the outer part with black
 484                         out_ptr = memfill( out_ptr, black, 2, out_x_range - in_x_range );
 485
 486                 // Move to next input line
 487                 in_line += istride;
 488                 }
 489                 else
 490                 {
 491                         // Fill whole line with black
 492                         out_ptr = memfill( out_ptr, black, 2, owidth );
 493                 }
 494
 495         // Move to next output line
 496         out_line += ostride;
 497         }
 498 }
 499
 500 /** A resizing function for yuv422 frames - this does not rescale, but simply
 501         resizes. It assumes yuv422 images available on the frame so use with care.
 502 */
 503
 504 uint8_t *mlt_frame_resize_yuv422( mlt_frame this, int owidth, int oheight )
 505 {
 506         // Get properties
 507         mlt_properties properties = mlt_frame_properties( this );
 508
 509         // Get the input image, width and height
 510         uint8_t *input = mlt_properties_get_data( properties, "image", NULL );
 511         int iwidth = mlt_properties_get_int( properties, "width" );
 512         int iheight = mlt_properties_get_int( properties, "height" );
 513
 514         // If width and height are correct, don't do anything
 515         if ( iwidth != owidth || iheight != oheight )
 516         {
 517                 // Create the output image
 518                 uint8_t *output = malloc( owidth * oheight * 2 );
 519
 520                 // Call the generic resize
 521                 mlt_resize_yuv422( output, owidth, oheight, input, iwidth, iheight );
 522
 523                 // Now update the frame
 524                 mlt_properties_set_data( properties, "image", output, owidth * oheight * 2, free, NULL );
 525                 mlt_properties_set_int( properties, "width", owidth );
 526                 mlt_properties_set_int( properties, "height", oheight );
 527
 528                 // Return the output
 529                 return output;
 530         }
 531
 532         // No change, return input
 533         return input;
 534 }
 535
 536 /** A rescaling function for yuv422 frames - low quality, and provided for testing
 537         only. It assumes yuv422 images available on the frame so use with care.
 538 */
 539
 540 uint8_t *mlt_frame_rescale_yuv422( mlt_frame this, int owidth, int oheight )
 541 {
 542         // Get properties
 543         mlt_properties properties = mlt_frame_properties( this );
 544
 545         // Get the input image, width and height
 546         uint8_t *input = mlt_properties_get_data( properties, "image", NULL );
 547         int iwidth = mlt_properties_get_int( properties, "width" );
 548         int iheight = mlt_properties_get_int( properties, "height" );
 549
 550         // If width and height are correct, don't do anything
 551         if ( iwidth != owidth || iheight != oheight )
 552         {
 553                 // Create the output image
 554                 uint8_t *output = malloc( owidth * oheight * 2 );
 555
 556                 // Calculate strides
 557                 int istride = iwidth * 2;
 558                 int ostride = owidth * 2;
 559
 560         // Coordinates (0,0 is middle of output)
 561         int y, x;
 562
 563                 // Derived coordinates
 564                 int dy, dx;
 565
 566         // Calculate ranges
 567         int out_x_range = owidth / 2;
 568         int out_y_range = oheight / 2;
 569         int in_x_range = iwidth / 2;
 570         int in_y_range = iheight / 2;
 571
 572         // Output pointers
 573         uint8_t *out_line = output;
 574         uint8_t *out_ptr;
 575
 576         // Calculate a middle pointer
 577         uint8_t *in_middle = input + istride * in_y_range + in_x_range * 2;
 578         uint8_t *in_line;
 579                 uint8_t *in_ptr;
 580
 581                 // Generate the affine transform scaling values
 582                 float scale_width = ( float )iwidth / ( float )owidth;
 583                 float scale_height = ( float )iheight / ( float )oheight;
 584
 585         // Loop for the entirety of our output height.
 586         for ( y = - out_y_range; y < out_y_range ; y ++ )
 587         {
 588                         // Calculate the derived y value
 589                         dy = scale_height * y;
 590
 591                 // Start at the beginning of the line
 592                 out_ptr = out_line;
 593
 594                 // Pointer to the middle of the input line
 595                 in_line = in_middle + dy * istride;
 596
 597                 // Loop for the entirety of our output row.
 598                 for ( x = - out_x_range; x < out_x_range; x += 1 )
 599                 {
 600                                 // Calculated the derived x
 601                                 dx = scale_width * x;
 602
 603                 // Check if x and y are in the valid input range.
 604                 if ( abs( dx ) < in_x_range && abs( dy ) < in_y_range  )
 605                 {
 606                         // We're in the input range for this row.
 607                                         in_ptr = in_line + ( dx >> 1 ) * 4 - 2 * ( x & 1 );
 608                         *out_ptr ++ = *in_ptr ++;
 609                         *out_ptr ++ = *in_ptr ++;
 610                 }
 611                 else
 612                 {
 613                         // We're not in the input range for this row.
 614                         *out_ptr ++ = 16;
 615                         *out_ptr ++ = 128;
 616                 }
 617                 }
 618
 619                 // Move to next output line
 620                 out_line += ostride;
 621         }
 622
 623                 // Now update the frame
 624                 mlt_properties_set_data( properties, "image", output, owidth * oheight * 2, free, NULL );
 625                 mlt_properties_set_int( properties, "width", owidth );
 626                 mlt_properties_set_int( properties, "height", oheight );
 627
 628                 // Return the output
 629                 return output;
 630         }
 631
 632         // No change, return input
 633         return input;
 634 }
 635