mirror of
				https://github.com/cookiengineer/audacity
				synced 2025-10-31 14:13:50 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			2347 lines
		
	
	
		
			53 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			2347 lines
		
	
	
		
			53 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /* -*- mode: C; mode: fold -*- */
 | |
| /*
 | |
|  * set/get functions for lame_global_flags
 | |
|  *
 | |
|  * Copyright (c) 2001-2005 Alexander Leidinger
 | |
|  *
 | |
|  * This library is free software; you can redistribute it and/or
 | |
|  * modify it under the terms of the GNU Library General Public
 | |
|  * License as published by the Free Software Foundation; either
 | |
|  * version 2 of the License, or (at your option) any later version.
 | |
|  *
 | |
|  * This library is distributed in the hope that it will be useful,
 | |
|  * but WITHOUT ANY WARRANTY; without even the implied warranty of
 | |
|  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 | |
|  * Library General Public License for more details.
 | |
|  *
 | |
|  * You should have received a copy of the GNU Library General Public
 | |
|  * License along with this library; if not, write to the
 | |
|  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 | |
|  * Boston, MA 02111-1307, USA.
 | |
|  */
 | |
| 
 | |
| /* $Id: set_get.c,v 1.104 2017/09/06 15:07:30 robert Exp $ */
 | |
| 
 | |
| #ifdef HAVE_CONFIG_H
 | |
| # include <config.h>
 | |
| #endif
 | |
| 
 | |
| #include "lame.h"
 | |
| #include "machine.h"
 | |
| #include "encoder.h"
 | |
| #include "util.h"
 | |
| #include "bitstream.h"  /* because of compute_flushbits */
 | |
| 
 | |
| #include "set_get.h"
 | |
| #include "lame_global_flags.h"
 | |
| 
 | |
| /*
 | |
|  * input stream description
 | |
|  */
 | |
| 
 | |
| 
 | |
| /* number of samples */
 | |
| /* it's unlikely for this function to return an error */
 | |
| int
 | |
| lame_set_num_samples(lame_global_flags * gfp, unsigned long num_samples)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 2^32-1 */
 | |
|         gfp->num_samples = num_samples;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| unsigned long
 | |
| lame_get_num_samples(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->num_samples;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* input samplerate */
 | |
| int
 | |
| lame_set_in_samplerate(lame_global_flags * gfp, int in_samplerate)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         if (in_samplerate < 1)
 | |
|             return -1;
 | |
|         /* input sample rate in Hz,  default = 44100 Hz */
 | |
|         gfp->samplerate_in = in_samplerate;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_in_samplerate(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->samplerate_in;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* number of channels in input stream */
 | |
| int
 | |
| lame_set_num_channels(lame_global_flags * gfp, int num_channels)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 2 */
 | |
|         if (2 < num_channels || 0 >= num_channels) {
 | |
|             return -1;  /* we don't support more than 2 channels */
 | |
|         }
 | |
|         gfp->num_channels = num_channels;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_num_channels(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->num_channels;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* scale the input by this amount before encoding (not used for decoding) */
 | |
| int
 | |
| lame_set_scale(lame_global_flags * gfp, float scale)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 1 */
 | |
|         gfp->scale = scale;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_scale(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->scale;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* scale the channel 0 (left) input by this amount before 
 | |
|    encoding (not used for decoding) */
 | |
| int
 | |
| lame_set_scale_left(lame_global_flags * gfp, float scale)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 1 */
 | |
|         gfp->scale_left = scale;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_scale_left(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->scale_left;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* scale the channel 1 (right) input by this amount before 
 | |
|    encoding (not used for decoding) */
 | |
| int
 | |
| lame_set_scale_right(lame_global_flags * gfp, float scale)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 1 */
 | |
|         gfp->scale_right = scale;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_scale_right(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->scale_right;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* output sample rate in Hz */
 | |
| int
 | |
| lame_set_out_samplerate(lame_global_flags * gfp, int out_samplerate)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /*
 | |
|          * default = 0: LAME picks best value based on the amount
 | |
|          *              of compression
 | |
|          * MPEG only allows:
 | |
|          *  MPEG1    32, 44.1,   48khz
 | |
|          *  MPEG2    16, 22.05,  24
 | |
|          *  MPEG2.5   8, 11.025, 12
 | |
|          *
 | |
|          * (not used by decoding routines)
 | |
|          */
 | |
|         if (out_samplerate != 0) {
 | |
|             int     v=0;
 | |
|             if (SmpFrqIndex(out_samplerate, &v) < 0)
 | |
|                 return -1;
 | |
|         }
 | |
|         gfp->samplerate_out = out_samplerate;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_out_samplerate(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->samplerate_out;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * general control parameters
 | |
|  */
 | |
| 
 | |
| /* collect data for an MP3 frame analzyer */
 | |
| int
 | |
| lame_set_analysis(lame_global_flags * gfp, int analysis)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > analysis || 1 < analysis)
 | |
|             return -1;
 | |
|         gfp->analysis = analysis;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_analysis(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->analysis && 1 >= gfp->analysis);
 | |
|         return gfp->analysis;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* write a Xing VBR header frame */
 | |
| int
 | |
| lame_set_bWriteVbrTag(lame_global_flags * gfp, int bWriteVbrTag)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 1 (on) for VBR/ABR modes, 0 (off) for CBR mode */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > bWriteVbrTag || 1 < bWriteVbrTag)
 | |
|             return -1;
 | |
|         gfp->write_lame_tag = bWriteVbrTag;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_bWriteVbrTag(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->write_lame_tag && 1 >= gfp->write_lame_tag);
 | |
|         return gfp->write_lame_tag;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| /* decode only, use lame/mpglib to convert mp3 to wav */
 | |
| int
 | |
| lame_set_decode_only(lame_global_flags * gfp, int decode_only)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > decode_only || 1 < decode_only)
 | |
|             return -1;
 | |
|         gfp->decode_only = decode_only;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_decode_only(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->decode_only && 1 >= gfp->decode_only);
 | |
|         return gfp->decode_only;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| #if DEPRECATED_OR_OBSOLETE_CODE_REMOVED
 | |
| /* 1=encode a Vorbis .ogg file.  default=0 */
 | |
| /* DEPRECATED */
 | |
| int CDECL lame_set_ogg(lame_global_flags *, int);
 | |
| int CDECL lame_get_ogg(const lame_global_flags *);
 | |
| #else
 | |
| #endif
 | |
| 
 | |
| /* encode a Vorbis .ogg file */
 | |
| /* DEPRECATED */
 | |
| int
 | |
| lame_set_ogg(lame_global_flags * gfp, int ogg)
 | |
| {
 | |
|     (void) gfp;
 | |
|     (void) ogg;
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_ogg(const lame_global_flags * gfp)
 | |
| {
 | |
|     (void) gfp;
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Internal algorithm selection.
 | |
|  * True quality is determined by the bitrate but this variable will effect
 | |
|  * quality by selecting expensive or cheap algorithms.
 | |
|  * quality=0..9.  0=best (very slow).  9=worst.  
 | |
|  * recommended:  3     near-best quality, not too slow
 | |
|  *               5     good quality, fast
 | |
|  *               7     ok quality, really fast
 | |
|  */
 | |
| int
 | |
| lame_set_quality(lame_global_flags * gfp, int quality)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         if (quality < 0) {
 | |
|             gfp->quality = 0;
 | |
|         }
 | |
|         else if (quality > 9) {
 | |
|             gfp->quality = 9;
 | |
|         }
 | |
|         else {
 | |
|             gfp->quality = quality;
 | |
|         }
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_quality(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->quality;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* mode = STEREO, JOINT_STEREO, DUAL_CHANNEL (not supported), MONO */
 | |
| int
 | |
| lame_set_mode(lame_global_flags * gfp, MPEG_mode mode)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         int     mpg_mode = mode;
 | |
|         /* default: lame chooses based on compression ratio and input channels */
 | |
|         if (mpg_mode < 0 || MAX_INDICATOR <= mpg_mode)
 | |
|             return -1;  /* Unknown MPEG mode! */
 | |
|         gfp->mode = mode;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| MPEG_mode
 | |
| lame_get_mode(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(gfp->mode < MAX_INDICATOR);
 | |
|         return gfp->mode;
 | |
|     }
 | |
|     return NOT_SET;
 | |
| }
 | |
| 
 | |
| 
 | |
| #if DEPRECATED_OR_OBSOLETE_CODE_REMOVED
 | |
| /*
 | |
|   mode_automs.  Use a M/S mode with a switching threshold based on
 | |
|   compression ratio
 | |
|   DEPRECATED
 | |
| */
 | |
| int CDECL lame_set_mode_automs(lame_global_flags *, int);
 | |
| int CDECL lame_get_mode_automs(const lame_global_flags *);
 | |
| #else
 | |
| #endif
 | |
| 
 | |
| /* Us a M/S mode with a switching threshold based on compression ratio */
 | |
| /* DEPRECATED */
 | |
| int
 | |
| lame_set_mode_automs(lame_global_flags * gfp, int mode_automs)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > mode_automs || 1 < mode_automs)
 | |
|             return -1;
 | |
|         lame_set_mode(gfp, JOINT_STEREO);
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_mode_automs(const lame_global_flags * gfp)
 | |
| {
 | |
|     (void) gfp;
 | |
|     return 1;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Force M/S for all frames.  For testing only.
 | |
|  * Requires mode = 1.
 | |
|  */
 | |
| int
 | |
| lame_set_force_ms(lame_global_flags * gfp, int force_ms)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > force_ms || 1 < force_ms)
 | |
|             return -1;
 | |
|         gfp->force_ms = force_ms;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_force_ms(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->force_ms && 1 >= gfp->force_ms);
 | |
|         return gfp->force_ms;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Use free_format. */
 | |
| int
 | |
| lame_set_free_format(lame_global_flags * gfp, int free_format)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > free_format || 1 < free_format)
 | |
|             return -1;
 | |
|         gfp->free_format = free_format;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_free_format(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->free_format && 1 >= gfp->free_format);
 | |
|         return gfp->free_format;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| /* Perform ReplayGain analysis */
 | |
| int
 | |
| lame_set_findReplayGain(lame_global_flags * gfp, int findReplayGain)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > findReplayGain || 1 < findReplayGain)
 | |
|             return -1;
 | |
|         gfp->findReplayGain = findReplayGain;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_findReplayGain(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->findReplayGain && 1 >= gfp->findReplayGain);
 | |
|         return gfp->findReplayGain;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Decode on the fly. Find the peak sample. If ReplayGain analysis is 
 | |
|    enabled then perform it on the decoded data. */
 | |
| int
 | |
| lame_set_decode_on_the_fly(lame_global_flags * gfp, int decode_on_the_fly)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
| #ifndef DECODE_ON_THE_FLY
 | |
|         return -1;
 | |
| #else
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > decode_on_the_fly || 1 < decode_on_the_fly)
 | |
|             return -1;
 | |
| 
 | |
|         gfp->decode_on_the_fly = decode_on_the_fly;
 | |
| 
 | |
|         return 0;
 | |
| #endif
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_decode_on_the_fly(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->decode_on_the_fly && 1 >= gfp->decode_on_the_fly);
 | |
|         return gfp->decode_on_the_fly;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| #if DEPRECATED_OR_OBSOLETE_CODE_REMOVED
 | |
| /* DEPRECATED: now does the same as lame_set_findReplayGain()
 | |
|    default = 0 (disabled) */
 | |
| int CDECL lame_set_ReplayGain_input(lame_global_flags *, int);
 | |
| int CDECL lame_get_ReplayGain_input(const lame_global_flags *);
 | |
| 
 | |
| /* DEPRECATED: now does the same as
 | |
|    lame_set_decode_on_the_fly() && lame_set_findReplayGain()
 | |
|    default = 0 (disabled) */
 | |
| int CDECL lame_set_ReplayGain_decode(lame_global_flags *, int);
 | |
| int CDECL lame_get_ReplayGain_decode(const lame_global_flags *);
 | |
| 
 | |
| /* DEPRECATED: now does the same as lame_set_decode_on_the_fly()
 | |
|    default = 0 (disabled) */
 | |
| int CDECL lame_set_findPeakSample(lame_global_flags *, int);
 | |
| int CDECL lame_get_findPeakSample(const lame_global_flags *);
 | |
| #else
 | |
| #endif
 | |
| 
 | |
| /* DEPRECATED. same as lame_set_decode_on_the_fly() */
 | |
| int
 | |
| lame_set_findPeakSample(lame_global_flags * gfp, int arg)
 | |
| {
 | |
|     return lame_set_decode_on_the_fly(gfp, arg);
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_findPeakSample(const lame_global_flags * gfp)
 | |
| {
 | |
|     return lame_get_decode_on_the_fly(gfp);
 | |
| }
 | |
| 
 | |
| /* DEPRECATED. same as lame_set_findReplayGain() */
 | |
| int
 | |
| lame_set_ReplayGain_input(lame_global_flags * gfp, int arg)
 | |
| {
 | |
|     return lame_set_findReplayGain(gfp, arg);
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_ReplayGain_input(const lame_global_flags * gfp)
 | |
| {
 | |
|     return lame_get_findReplayGain(gfp);
 | |
| }
 | |
| 
 | |
| /* DEPRECATED. same as lame_set_decode_on_the_fly() &&
 | |
|    lame_set_findReplayGain() */
 | |
| int
 | |
| lame_set_ReplayGain_decode(lame_global_flags * gfp, int arg)
 | |
| {
 | |
|     if (lame_set_decode_on_the_fly(gfp, arg) < 0 || lame_set_findReplayGain(gfp, arg) < 0)
 | |
|         return -1;
 | |
|     else
 | |
|         return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_ReplayGain_decode(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (lame_get_decode_on_the_fly(gfp) > 0 && lame_get_findReplayGain(gfp) > 0)
 | |
|         return 1;
 | |
|     else
 | |
|         return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* set and get some gapless encoding flags */
 | |
| 
 | |
| int
 | |
| lame_set_nogap_total(lame_global_flags * gfp, int the_nogap_total)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->nogap_total = the_nogap_total;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_nogap_total(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->nogap_total;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_nogap_currentindex(lame_global_flags * gfp, int the_nogap_index)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->nogap_current = the_nogap_index;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_nogap_currentindex(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->nogap_current;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* message handlers */
 | |
| int
 | |
| lame_set_errorf(lame_global_flags * gfp, void (*func) (const char *, va_list))
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->report.errorf = func;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_debugf(lame_global_flags * gfp, void (*func) (const char *, va_list))
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->report.debugf = func;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_msgf(lame_global_flags * gfp, void (*func) (const char *, va_list))
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->report.msgf = func;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Set one of
 | |
|  *  - brate
 | |
|  *  - compression ratio.
 | |
|  *
 | |
|  * Default is compression ratio of 11.
 | |
|  */
 | |
| int
 | |
| lame_set_brate(lame_global_flags * gfp, int brate)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->brate = brate;
 | |
|         if (brate > 320) {
 | |
|             gfp->disable_reservoir = 1;
 | |
|         }
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_brate(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->brate;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_compression_ratio(lame_global_flags * gfp, float compression_ratio)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->compression_ratio = compression_ratio;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_compression_ratio(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->compression_ratio;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * frame parameters
 | |
|  */
 | |
| 
 | |
| /* Mark as copyright protected. */
 | |
| int
 | |
| lame_set_copyright(lame_global_flags * gfp, int copyright)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > copyright || 1 < copyright)
 | |
|             return -1;
 | |
|         gfp->copyright = copyright;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_copyright(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->copyright && 1 >= gfp->copyright);
 | |
|         return gfp->copyright;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Mark as original. */
 | |
| int
 | |
| lame_set_original(lame_global_flags * gfp, int original)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 1 (enabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > original || 1 < original)
 | |
|             return -1;
 | |
|         gfp->original = original;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_original(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->original && 1 >= gfp->original);
 | |
|         return gfp->original;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * error_protection.
 | |
|  * Use 2 bytes from each frame for CRC checksum.
 | |
|  */
 | |
| int
 | |
| lame_set_error_protection(lame_global_flags * gfp, int error_protection)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > error_protection || 1 < error_protection)
 | |
|             return -1;
 | |
|         gfp->error_protection = error_protection;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_error_protection(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->error_protection && 1 >= gfp->error_protection);
 | |
|         return gfp->error_protection;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| #if DEPRECATED_OR_OBSOLETE_CODE_REMOVED
 | |
| /* padding_type. 0=pad no frames  1=pad all frames 2=adjust padding(default) */
 | |
| int CDECL lame_set_padding_type(lame_global_flags *, Padding_type);
 | |
| Padding_type CDECL lame_get_padding_type(const lame_global_flags *);
 | |
| #else
 | |
| #endif
 | |
| 
 | |
| /*
 | |
|  * padding_type.
 | |
|  *  PAD_NO     = pad no frames
 | |
|  *  PAD_ALL    = pad all frames
 | |
|  *  PAD_ADJUST = adjust padding
 | |
|  */
 | |
| int
 | |
| lame_set_padding_type(lame_global_flags * gfp, Padding_type padding_type)
 | |
| {
 | |
|     (void) gfp;
 | |
|     (void) padding_type;
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| Padding_type
 | |
| lame_get_padding_type(const lame_global_flags * gfp)
 | |
| {
 | |
|     (void) gfp;
 | |
|     return PAD_ADJUST;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* MP3 'private extension' bit. Meaningless. */
 | |
| int
 | |
| lame_set_extension(lame_global_flags * gfp, int extension)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > extension || 1 < extension)
 | |
|             return -1;
 | |
|         gfp->extension = extension;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_extension(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->extension && 1 >= gfp->extension);
 | |
|         return gfp->extension;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Enforce strict ISO compliance. */
 | |
| int
 | |
| lame_set_strict_ISO(lame_global_flags * gfp, int val)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (val < MDB_DEFAULT || MDB_MAXIMUM < val)
 | |
|             return -1;
 | |
|         gfp->strict_ISO = val;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_strict_ISO(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->strict_ISO;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| /********************************************************************
 | |
|  * quantization/noise shaping 
 | |
|  ***********************************************************************/
 | |
| 
 | |
| /* Disable the bit reservoir. For testing only. */
 | |
| int
 | |
| lame_set_disable_reservoir(lame_global_flags * gfp, int disable_reservoir)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > disable_reservoir || 1 < disable_reservoir)
 | |
|             return -1;
 | |
|         gfp->disable_reservoir = disable_reservoir;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_disable_reservoir(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->disable_reservoir && 1 >= gfp->disable_reservoir);
 | |
|         return gfp->disable_reservoir;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| int
 | |
| lame_set_experimentalX(lame_global_flags * gfp, int experimentalX)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_set_quant_comp(gfp, experimentalX);
 | |
|         lame_set_quant_comp_short(gfp, experimentalX);
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_experimentalX(const lame_global_flags * gfp)
 | |
| {
 | |
|     return lame_get_quant_comp(gfp);
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Select a different "best quantization" function. default = 0 */
 | |
| int
 | |
| lame_set_quant_comp(lame_global_flags * gfp, int quant_type)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->quant_comp = quant_type;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_quant_comp(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->quant_comp;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Select a different "best quantization" function. default = 0 */
 | |
| int
 | |
| lame_set_quant_comp_short(lame_global_flags * gfp, int quant_type)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->quant_comp_short = quant_type;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_quant_comp_short(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->quant_comp_short;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Another experimental option. For testing only. */
 | |
| int
 | |
| lame_set_experimentalY(lame_global_flags * gfp, int experimentalY)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->experimentalY = experimentalY;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_experimentalY(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->experimentalY;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| int
 | |
| lame_set_experimentalZ(lame_global_flags * gfp, int experimentalZ)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->experimentalZ = experimentalZ;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_experimentalZ(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->experimentalZ;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Naoki's psycho acoustic model. */
 | |
| int
 | |
| lame_set_exp_nspsytune(lame_global_flags * gfp, int exp_nspsytune)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
|         gfp->exp_nspsytune = exp_nspsytune;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_exp_nspsytune(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->exp_nspsytune;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| /********************************************************************
 | |
|  * VBR control
 | |
|  ***********************************************************************/
 | |
| 
 | |
| /* Types of VBR.  default = vbr_off = CBR */
 | |
| int
 | |
| lame_set_VBR(lame_global_flags * gfp, vbr_mode VBR)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         int     vbr_q = VBR;
 | |
|         if (0 > vbr_q || vbr_max_indicator <= vbr_q)
 | |
|             return -1;  /* Unknown VBR mode! */
 | |
|         gfp->VBR = VBR;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| vbr_mode
 | |
| lame_get_VBR(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(gfp->VBR < vbr_max_indicator);
 | |
|         return gfp->VBR;
 | |
|     }
 | |
|     return vbr_off;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * VBR quality level.
 | |
|  *  0 = highest
 | |
|  *  9 = lowest 
 | |
|  */
 | |
| int
 | |
| lame_set_VBR_q(lame_global_flags * gfp, int VBR_q)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         int     ret = 0;
 | |
| 
 | |
|         if (0 > VBR_q) {
 | |
|             ret = -1;   /* Unknown VBR quality level! */
 | |
|             VBR_q = 0;
 | |
|         }
 | |
|         if (9 < VBR_q) {
 | |
|             ret = -1;
 | |
|             VBR_q = 9;
 | |
|         }
 | |
|         gfp->VBR_q = VBR_q;
 | |
|         gfp->VBR_q_frac = 0;
 | |
|         return ret;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_VBR_q(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->VBR_q && 10 > gfp->VBR_q);
 | |
|         return gfp->VBR_q;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_VBR_quality(lame_global_flags * gfp, float VBR_q)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         int     ret = 0;
 | |
| 
 | |
|         if (0 > VBR_q) {
 | |
|             ret = -1;   /* Unknown VBR quality level! */
 | |
|             VBR_q = 0;
 | |
|         }
 | |
|         if (9.999 < VBR_q) {
 | |
|             ret = -1;
 | |
|             VBR_q = 9.999;
 | |
|         }
 | |
| 
 | |
|         gfp->VBR_q = (int) VBR_q;
 | |
|         gfp->VBR_q_frac = VBR_q - gfp->VBR_q;
 | |
| 
 | |
|         return ret;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_VBR_quality(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->VBR_q + gfp->VBR_q_frac;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Ignored except for VBR = vbr_abr (ABR mode) */
 | |
| int
 | |
| lame_set_VBR_mean_bitrate_kbps(lame_global_flags * gfp, int VBR_mean_bitrate_kbps)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->VBR_mean_bitrate_kbps = VBR_mean_bitrate_kbps;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_VBR_mean_bitrate_kbps(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->VBR_mean_bitrate_kbps;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_VBR_min_bitrate_kbps(lame_global_flags * gfp, int VBR_min_bitrate_kbps)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->VBR_min_bitrate_kbps = VBR_min_bitrate_kbps;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_VBR_min_bitrate_kbps(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->VBR_min_bitrate_kbps;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_VBR_max_bitrate_kbps(lame_global_flags * gfp, int VBR_max_bitrate_kbps)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->VBR_max_bitrate_kbps = VBR_max_bitrate_kbps;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_VBR_max_bitrate_kbps(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->VBR_max_bitrate_kbps;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Strictly enforce VBR_min_bitrate.
 | |
|  * Normally it will be violated for analog silence.
 | |
|  */
 | |
| int
 | |
| lame_set_VBR_hard_min(lame_global_flags * gfp, int VBR_hard_min)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 (disabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > VBR_hard_min || 1 < VBR_hard_min)
 | |
|             return -1;
 | |
| 
 | |
|         gfp->VBR_hard_min = VBR_hard_min;
 | |
| 
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_VBR_hard_min(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->VBR_hard_min && 1 >= gfp->VBR_hard_min);
 | |
|         return gfp->VBR_hard_min;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /********************************************************************
 | |
|  * Filtering control
 | |
|  ***********************************************************************/
 | |
| 
 | |
| /*
 | |
|  * Freqency in Hz to apply lowpass.
 | |
|  *   0 = default = lame chooses
 | |
|  *  -1 = disabled
 | |
|  */
 | |
| int
 | |
| lame_set_lowpassfreq(lame_global_flags * gfp, int lowpassfreq)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->lowpassfreq = lowpassfreq;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_lowpassfreq(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->lowpassfreq;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Width of transition band (in Hz).
 | |
|  *  default = one polyphase filter band
 | |
|  */
 | |
| int
 | |
| lame_set_lowpasswidth(lame_global_flags * gfp, int lowpasswidth)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->lowpasswidth = lowpasswidth;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_lowpasswidth(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->lowpasswidth;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Frequency in Hz to apply highpass.
 | |
|  *   0 = default = lame chooses
 | |
|  *  -1 = disabled
 | |
|  */
 | |
| int
 | |
| lame_set_highpassfreq(lame_global_flags * gfp, int highpassfreq)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->highpassfreq = highpassfreq;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_highpassfreq(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->highpassfreq;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Width of transition band (in Hz).
 | |
|  *  default = one polyphase filter band
 | |
|  */
 | |
| int
 | |
| lame_set_highpasswidth(lame_global_flags * gfp, int highpasswidth)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->highpasswidth = highpasswidth;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_highpasswidth(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->highpasswidth;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * psycho acoustics and other arguments which you should not change 
 | |
|  * unless you know what you are doing
 | |
|  */
 | |
| 
 | |
| 
 | |
| /* Adjust masking values. */
 | |
| int
 | |
| lame_set_maskingadjust(lame_global_flags * gfp, float adjust)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->maskingadjust = adjust;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_maskingadjust(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->maskingadjust;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_maskingadjust_short(lame_global_flags * gfp, float adjust)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->maskingadjust_short = adjust;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_maskingadjust_short(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->maskingadjust_short;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| /* Only use ATH for masking. */
 | |
| int
 | |
| lame_set_ATHonly(lame_global_flags * gfp, int ATHonly)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->ATHonly = ATHonly;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_ATHonly(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->ATHonly;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Only use ATH for short blocks. */
 | |
| int
 | |
| lame_set_ATHshort(lame_global_flags * gfp, int ATHshort)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->ATHshort = ATHshort;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_ATHshort(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->ATHshort;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Disable ATH. */
 | |
| int
 | |
| lame_set_noATH(lame_global_flags * gfp, int noATH)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->noATH = noATH;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_noATH(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->noATH;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Select ATH formula. */
 | |
| int
 | |
| lame_set_ATHtype(lame_global_flags * gfp, int ATHtype)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* XXX: ATHtype should be converted to an enum. */
 | |
|         gfp->ATHtype = ATHtype;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_ATHtype(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->ATHtype;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Select ATH formula 4 shape. */
 | |
| int
 | |
| lame_set_ATHcurve(lame_global_flags * gfp, float ATHcurve)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->ATHcurve = ATHcurve;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_ATHcurve(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->ATHcurve;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Lower ATH by this many db. */
 | |
| int
 | |
| lame_set_ATHlower(lame_global_flags * gfp, float ATHlower)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->ATH_lower_db = ATHlower;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_ATHlower(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->ATH_lower_db;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Select ATH adaptive adjustment scheme. */
 | |
| int
 | |
| lame_set_athaa_type(lame_global_flags * gfp, int athaa_type)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->athaa_type = athaa_type;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_athaa_type(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->athaa_type;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| #if DEPRECATED_OR_OBSOLETE_CODE_REMOVED
 | |
| int CDECL lame_set_athaa_loudapprox(lame_global_flags * gfp, int athaa_loudapprox);
 | |
| int CDECL lame_get_athaa_loudapprox(const lame_global_flags * gfp);
 | |
| #else
 | |
| #endif
 | |
| 
 | |
| /* Select the loudness approximation used by the ATH adaptive auto-leveling. */
 | |
| int
 | |
| lame_set_athaa_loudapprox(lame_global_flags * gfp, int athaa_loudapprox)
 | |
| {
 | |
|     (void) gfp;
 | |
|     (void) athaa_loudapprox;
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_athaa_loudapprox(const lame_global_flags * gfp)
 | |
| {
 | |
|     (void) gfp;
 | |
|     /* obsolete, the type known under number 2 is the only survival */
 | |
|     return 2;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Adjust (in dB) the point below which adaptive ATH level adjustment occurs. */
 | |
| int
 | |
| lame_set_athaa_sensitivity(lame_global_flags * gfp, float athaa_sensitivity)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->athaa_sensitivity = athaa_sensitivity;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_athaa_sensitivity(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->athaa_sensitivity;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Predictability limit (ISO tonality formula) */
 | |
| int     lame_set_cwlimit(lame_global_flags * gfp, int cwlimit);
 | |
| int     lame_get_cwlimit(const lame_global_flags * gfp);
 | |
| 
 | |
| int
 | |
| lame_set_cwlimit(lame_global_flags * gfp, int cwlimit)
 | |
| {
 | |
|     (void) gfp;
 | |
|     (void) cwlimit;
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_cwlimit(const lame_global_flags * gfp)
 | |
| {
 | |
|     (void) gfp;
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Allow blocktypes to differ between channels.
 | |
|  * default:
 | |
|  *  0 for jstereo => block types coupled
 | |
|  *  1 for stereo  => block types may differ
 | |
|  */
 | |
| int
 | |
| lame_set_allow_diff_short(lame_global_flags * gfp, int allow_diff_short)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->short_blocks = allow_diff_short ? short_block_allowed : short_block_coupled;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_allow_diff_short(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         if (gfp->short_blocks == short_block_allowed)
 | |
|             return 1;   /* short blocks allowed to differ */
 | |
|         else
 | |
|             return 0;   /* not set, dispensed, forced or coupled */
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Use temporal masking effect */
 | |
| int
 | |
| lame_set_useTemporal(lame_global_flags * gfp, int useTemporal)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 1 (enabled) */
 | |
| 
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 <= useTemporal && useTemporal <= 1) {
 | |
|             gfp->useTemporal = useTemporal;
 | |
|             return 0;
 | |
|         }
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_useTemporal(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->useTemporal && 1 >= gfp->useTemporal);
 | |
|         return gfp->useTemporal;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Use inter-channel masking effect */
 | |
| int
 | |
| lame_set_interChRatio(lame_global_flags * gfp, float ratio)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0.0 (no inter-channel maskin) */
 | |
|         if (0 <= ratio && ratio <= 1.0) {
 | |
|             gfp->interChRatio = ratio;
 | |
|             return 0;
 | |
|         }
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_interChRatio(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert((0 <= gfp->interChRatio && gfp->interChRatio <= 1.0) || EQ(gfp->interChRatio, -1.0));
 | |
|         return gfp->interChRatio;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Use pseudo substep shaping method */
 | |
| int
 | |
| lame_set_substep(lame_global_flags * gfp, int method)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0.0 (no substep noise shaping) */
 | |
|         if (0 <= method && method <= 7) {
 | |
|             gfp->substep_shaping = method;
 | |
|             return 0;
 | |
|         }
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_substep(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->substep_shaping && gfp->substep_shaping <= 7);
 | |
|         return gfp->substep_shaping;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| /* scalefactors scale */
 | |
| int
 | |
| lame_set_sfscale(lame_global_flags * gfp, int val)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->noise_shaping = (val != 0) ? 2 : 1;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_sfscale(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return (gfp->noise_shaping == 2) ? 1 : 0;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| /* subblock gain */
 | |
| int
 | |
| lame_set_subblock_gain(lame_global_flags * gfp, int sbgain)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->subblock_gain = sbgain;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_subblock_gain(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->subblock_gain;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Disable short blocks. */
 | |
| int
 | |
| lame_set_no_short_blocks(lame_global_flags * gfp, int no_short_blocks)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 <= no_short_blocks && no_short_blocks <= 1) {
 | |
|             gfp->short_blocks = no_short_blocks ? short_block_dispensed : short_block_allowed;
 | |
|             return 0;
 | |
|         }
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_no_short_blocks(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         switch (gfp->short_blocks) {
 | |
|         default:
 | |
|         case short_block_not_set:
 | |
|             return -1;
 | |
|         case short_block_dispensed:
 | |
|             return 1;
 | |
|         case short_block_allowed:
 | |
|         case short_block_coupled:
 | |
|         case short_block_forced:
 | |
|             return 0;
 | |
|         }
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Force short blocks. */
 | |
| int
 | |
| lame_set_force_short_blocks(lame_global_flags * gfp, int short_blocks)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* enforce disable/enable meaning, if we need more than two values
 | |
|            we need to switch to an enum to have an apropriate representation
 | |
|            of the possible meanings of the value */
 | |
|         if (0 > short_blocks || 1 < short_blocks)
 | |
|             return -1;
 | |
| 
 | |
|         if (short_blocks == 1)
 | |
|             gfp->short_blocks = short_block_forced;
 | |
|         else if (gfp->short_blocks == short_block_forced)
 | |
|             gfp->short_blocks = short_block_allowed;
 | |
| 
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_force_short_blocks(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         switch (gfp->short_blocks) {
 | |
|         default:
 | |
|         case short_block_not_set:
 | |
|             return -1;
 | |
|         case short_block_dispensed:
 | |
|         case short_block_allowed:
 | |
|         case short_block_coupled:
 | |
|             return 0;
 | |
|         case short_block_forced:
 | |
|             return 1;
 | |
|         }
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_short_threshold_lrm(lame_global_flags * gfp, float lrm)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->attackthre = lrm;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_short_threshold_lrm(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->attackthre;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_short_threshold_s(lame_global_flags * gfp, float s)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->attackthre_s = s;
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_short_threshold_s(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->attackthre_s;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_set_short_threshold(lame_global_flags * gfp, float lrm, float s)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_set_short_threshold_lrm(gfp, lrm);
 | |
|         lame_set_short_threshold_s(gfp, s);
 | |
|         return 0;
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * Input PCM is emphased PCM
 | |
|  * (for instance from one of the rarely emphased CDs).
 | |
|  *
 | |
|  * It is STRONGLY not recommended to use this, because psycho does not
 | |
|  * take it into account, and last but not least many decoders
 | |
|  * ignore these bits
 | |
|  */
 | |
| int
 | |
| lame_set_emphasis(lame_global_flags * gfp, int emphasis)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* XXX: emphasis should be converted to an enum */
 | |
|         if (0 <= emphasis && emphasis < 4) {
 | |
|             gfp->emphasis = emphasis;
 | |
|             return 0;
 | |
|         }
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_emphasis(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         assert(0 <= gfp->emphasis && gfp->emphasis < 4);
 | |
|         return gfp->emphasis;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| /***************************************************************/
 | |
| /* internal variables, cannot be set...                        */
 | |
| /* provided because they may be of use to calling application  */
 | |
| /***************************************************************/
 | |
| 
 | |
| /* MPEG version.
 | |
|  *  0 = MPEG-2
 | |
|  *  1 = MPEG-1
 | |
|  * (2 = MPEG-2.5)    
 | |
|  */
 | |
| int
 | |
| lame_get_version(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return gfc->cfg.version;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Encoder delay. */
 | |
| int
 | |
| lame_get_encoder_delay(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return gfc->ov_enc.encoder_delay;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| /* padding added to the end of the input */
 | |
| int
 | |
| lame_get_encoder_padding(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return gfc->ov_enc.encoder_padding;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Size of MPEG frame. */
 | |
| int
 | |
| lame_get_framesize(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             SessionConfig_t const *const cfg = &gfc->cfg;
 | |
|             return 576 * cfg->mode_gr;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /* Number of frames encoded so far. */
 | |
| int
 | |
| lame_get_frameNum(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return gfc->ov_enc.frame_number;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_mf_samples_to_encode(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return gfc->sv_enc.mf_samples_to_encode;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int     CDECL
 | |
| lame_get_size_mp3buffer(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             int     size;
 | |
|             compute_flushbits(gfc, &size);
 | |
|             return size;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_RadioGain(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return gfc->ov_rpg.RadioGain;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_AudiophileGain(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return 0;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_PeakSample(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return (float) gfc->ov_rpg.PeakSample;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_noclipGainChange(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return gfc->ov_rpg.noclipGainChange;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_noclipScale(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return gfc->ov_rpg.noclipScale;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
|  * LAME's estimate of the total number of frames to be encoded.
 | |
|  * Only valid if calling program set num_samples.
 | |
|  */
 | |
| int
 | |
| lame_get_totalframes(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             SessionConfig_t const *const cfg = &gfc->cfg;
 | |
|             unsigned long const pcm_samples_per_frame = 576 * cfg->mode_gr;
 | |
|             unsigned long pcm_samples_to_encode = gfp->num_samples;
 | |
|             unsigned long end_padding = 0;
 | |
|             int frames = 0;
 | |
| 
 | |
|             if (pcm_samples_to_encode == (0ul-1ul))
 | |
|                 return 0; /* unknown */
 | |
| 
 | |
|             /* estimate based on user set num_samples: */
 | |
|             if (cfg->samplerate_in != cfg->samplerate_out) {
 | |
|                 /* resampling, estimate new samples_to_encode */
 | |
|                 double resampled_samples_to_encode = 0.0, frames_f = 0.0;
 | |
|                 if (cfg->samplerate_in > 0) {
 | |
|                     resampled_samples_to_encode = pcm_samples_to_encode;
 | |
|                     resampled_samples_to_encode *= cfg->samplerate_out;
 | |
|                     resampled_samples_to_encode /= cfg->samplerate_in;
 | |
|                 }
 | |
|                 if (resampled_samples_to_encode <= 0.0)
 | |
|                     return 0; /* unlikely to happen, so what, no estimate! */
 | |
|                 frames_f = floor(resampled_samples_to_encode / pcm_samples_per_frame);
 | |
|                 if (frames_f >= (INT_MAX-2))
 | |
|                     return 0; /* overflow, happens eventually, no estimate! */
 | |
|                 frames = frames_f;
 | |
|                 resampled_samples_to_encode -= frames * pcm_samples_per_frame;
 | |
|                 pcm_samples_to_encode = ceil(resampled_samples_to_encode);
 | |
|             }
 | |
|             else {
 | |
|                 frames = pcm_samples_to_encode / pcm_samples_per_frame;
 | |
|                 pcm_samples_to_encode -= frames * pcm_samples_per_frame;
 | |
|             }
 | |
|             pcm_samples_to_encode += 576ul;
 | |
|             end_padding = pcm_samples_per_frame - (pcm_samples_to_encode % pcm_samples_per_frame);
 | |
|             if (end_padding < 576ul) {
 | |
|                 end_padding += pcm_samples_per_frame;
 | |
|             }
 | |
|             pcm_samples_to_encode += end_padding;
 | |
|             frames += (pcm_samples_to_encode / pcm_samples_per_frame);
 | |
|             /* check to see if we underestimated totalframes */
 | |
|             /*    if (totalframes < gfp->frameNum) */
 | |
|             /*        totalframes = gfp->frameNum; */
 | |
|             return frames;
 | |
|         }
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| int
 | |
| lame_set_preset(lame_global_flags * gfp, int preset)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->preset = preset;
 | |
|         return apply_preset(gfp, preset, 1);
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| int
 | |
| lame_set_asm_optimizations(lame_global_flags * gfp, int optim, int mode)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         mode = (mode == 1 ? 1 : 0);
 | |
|         switch (optim) {
 | |
|         case MMX:{
 | |
|                 gfp->asm_optimizations.mmx = mode;
 | |
|                 return optim;
 | |
|             }
 | |
|         case AMD_3DNOW:{
 | |
|                 gfp->asm_optimizations.amd3dnow = mode;
 | |
|                 return optim;
 | |
|             }
 | |
|         case SSE:{
 | |
|                 gfp->asm_optimizations.sse = mode;
 | |
|                 return optim;
 | |
|             }
 | |
|         default:
 | |
|             return optim;
 | |
|         }
 | |
|     }
 | |
|     return -1;
 | |
| }
 | |
| 
 | |
| 
 | |
| void
 | |
| lame_set_write_id3tag_automatic(lame_global_flags * gfp, int v)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->write_id3tag_automatic = v;
 | |
|     }
 | |
| }
 | |
| 
 | |
| 
 | |
| int
 | |
| lame_get_write_id3tag_automatic(lame_global_flags const *gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->write_id3tag_automatic;
 | |
|     }
 | |
|     return 1;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*
 | |
| 
 | |
| UNDOCUMENTED, experimental settings.  These routines are not prototyped
 | |
| in lame.h.  You should not use them, they are experimental and may
 | |
| change.  
 | |
| 
 | |
| */
 | |
| 
 | |
| 
 | |
| /*
 | |
|  *  just another daily changing developer switch  
 | |
|  */
 | |
| void CDECL lame_set_tune(lame_global_flags *, float);
 | |
| 
 | |
| void
 | |
| lame_set_tune(lame_global_flags * gfp, float val)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         gfp->tune_value_a = val;
 | |
|         gfp->tune = 1;
 | |
|     }
 | |
| }
 | |
| 
 | |
| /* Custom msfix hack */
 | |
| void
 | |
| lame_set_msfix(lame_global_flags * gfp, double msfix)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         /* default = 0 */
 | |
|         gfp->msfix = msfix;
 | |
|     }
 | |
| }
 | |
| 
 | |
| float
 | |
| lame_get_msfix(const lame_global_flags * gfp)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         return gfp->msfix;
 | |
|     }
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| #if DEPRECATED_OR_OBSOLETE_CODE_REMOVED
 | |
| int CDECL lame_set_preset_expopts(lame_global_flags *, int);
 | |
| #else
 | |
| #endif
 | |
| 
 | |
| int
 | |
| lame_set_preset_expopts(lame_global_flags * gfp, int preset_expopts)
 | |
| {
 | |
|     (void) gfp;
 | |
|     (void) preset_expopts;
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| 
 | |
| int
 | |
| lame_set_preset_notune(lame_global_flags * gfp, int preset_notune)
 | |
| {
 | |
|     (void) gfp;
 | |
|     (void) preset_notune;
 | |
|     return 0;
 | |
| }
 | |
| 
 | |
| static int
 | |
| calc_maximum_input_samples_for_buffer_size(lame_internal_flags const* gfc, size_t buffer_size)
 | |
| {
 | |
|     SessionConfig_t const *const cfg = &gfc->cfg;
 | |
|     int const pcm_samples_per_frame = 576 * cfg->mode_gr;
 | |
|     int     frames_per_buffer = 0, input_samples_per_buffer = 0;
 | |
|     int     kbps = 320;
 | |
| 
 | |
|     if (cfg->samplerate_out < 16000)
 | |
|         kbps = 64;
 | |
|     else if (cfg->samplerate_out < 32000)
 | |
|         kbps = 160;
 | |
|     else
 | |
|         kbps = 320;
 | |
|     if (cfg->free_format)
 | |
|         kbps = cfg->avg_bitrate;
 | |
|     else if (cfg->vbr == vbr_off) {
 | |
|         kbps = cfg->avg_bitrate;
 | |
|     }
 | |
|     {
 | |
|         int const pad = 1;
 | |
|         int const bpf = ((cfg->version + 1) * 72000 * kbps / cfg->samplerate_out + pad);
 | |
|         frames_per_buffer = buffer_size / bpf;
 | |
|     }
 | |
|     {
 | |
|         double ratio = (double) cfg->samplerate_in / cfg->samplerate_out;
 | |
|         input_samples_per_buffer = pcm_samples_per_frame * frames_per_buffer * ratio;
 | |
|     }
 | |
|     return input_samples_per_buffer;
 | |
| }
 | |
| 
 | |
| int
 | |
| lame_get_maximum_number_of_samples(lame_t gfp, size_t buffer_size)
 | |
| {
 | |
|     if (is_lame_global_flags_valid(gfp)) {
 | |
|         lame_internal_flags const *const gfc = gfp->internal_flags;
 | |
|         if (is_lame_internal_flags_valid(gfc)) {
 | |
|             return calc_maximum_input_samples_for_buffer_size(gfc, buffer_size);
 | |
|         }
 | |
|     }
 | |
|     return LAME_GENERICERROR;
 | |
| }
 |