more new format stuff to VipsFile
This commit is contained in:
parent
09aa42393a
commit
9cb602baa1
6
TODO
6
TODO
@ -1,6 +1,12 @@
|
||||
- we need loaders to be able to directly write to an image with no copy
|
||||
operation
|
||||
|
||||
- format should be a subclass of operation
|
||||
|
||||
- rename format as VipsFile? move format to deprecated, only way to keep
|
||||
compat
|
||||
|
||||
|
||||
|
||||
|
||||
- vipsimage should be cached too, eg.
|
||||
|
@ -635,6 +635,7 @@ AC_OUTPUT([
|
||||
libvips/convolution/Makefile
|
||||
libvips/deprecated/Makefile
|
||||
libvips/format/Makefile
|
||||
libvips/file/Makefile
|
||||
libvips/freq_filt/Makefile
|
||||
libvips/histograms_lut/Makefile
|
||||
libvips/inplace/Makefile
|
||||
|
@ -10,6 +10,7 @@ C_LIB =
|
||||
endif
|
||||
|
||||
SUBDIRS = \
|
||||
file \
|
||||
include \
|
||||
arithmetic \
|
||||
resample \
|
||||
@ -52,6 +53,7 @@ libvips_la_LIBADD = \
|
||||
deprecated/libdeprecated.la \
|
||||
$(C_LIB) \
|
||||
format/libformat.la \
|
||||
file/libfile.la \
|
||||
freq_filt/libfreq_filt.la \
|
||||
histograms_lut/libhistograms_lut.la \
|
||||
inplace/libinplace.la \
|
||||
|
6
libvips/file/Makefile.am
Normal file
6
libvips/file/Makefile.am
Normal file
@ -0,0 +1,6 @@
|
||||
noinst_LTLIBRARIES = libfile.la
|
||||
|
||||
libfile_la_SOURCES = \
|
||||
file.c
|
||||
|
||||
INCLUDES = -I${top_srcdir}/libvips/include @VIPS_CFLAGS@ @VIPS_INCLUDES@
|
607
libvips/file/file.c
Normal file
607
libvips/file/file.c
Normal file
@ -0,0 +1,607 @@
|
||||
/* VIPS function dispatch tables for image format load/save.
|
||||
*/
|
||||
|
||||
/*
|
||||
|
||||
This file is part of VIPS.
|
||||
|
||||
VIPS is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU Lesser General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program 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 Lesser General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU Lesser General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
|
||||
*/
|
||||
|
||||
/*
|
||||
|
||||
These files are distributed with VIPS - http://www.vips.ecs.soton.ac.uk
|
||||
|
||||
*/
|
||||
|
||||
#ifdef HAVE_CONFIG_H
|
||||
#include <config.h>
|
||||
#endif /*HAVE_CONFIG_H*/
|
||||
#include <vips/intl.h>
|
||||
|
||||
#include <stdio.h>
|
||||
|
||||
#include <vips/vips.h>
|
||||
#include <vips/internal.h>
|
||||
|
||||
/**
|
||||
* SECTION: format
|
||||
* @short_description: load and save in a variety of formats
|
||||
* @stability: Stable
|
||||
* @see_also: <link linkend="libvips-image">image</link>
|
||||
* @include: vips/vips.h
|
||||
*
|
||||
* VIPS has a simple system for representing image load and save operations in
|
||||
* a generic way.
|
||||
*
|
||||
* You can ask for a loader for a certain file or select a saver based on a
|
||||
* filename. Once you have found a format, you can use it to load a file of
|
||||
* that type, save an image to a file of that type, query files for their type
|
||||
* and fields, and ask for supported features. You can also call the
|
||||
* converters directly, if you like.
|
||||
*
|
||||
* If you define a new format, support for
|
||||
* it automatically appears in all VIPS user-interfaces. It will also be
|
||||
* transparently supported by vips_image_new_from_file() and friends.
|
||||
*
|
||||
* VIPS comes with VipsFormat for TIFF, JPEG, PNG, Analyze, PPM, OpenEXR, CSV,
|
||||
* Matlab, Radiance, RAW, VIPS and one that wraps libMagick.
|
||||
*/
|
||||
|
||||
/**
|
||||
* VipsFormatFlags:
|
||||
* @VIPS_FORMAT_NONE: no flags set
|
||||
* @VIPS_FORMAT_PARTIAL: the image may be read lazilly
|
||||
* @VIPS_FORMAT_BIGENDIAN: image pixels are most-significant byte first
|
||||
*
|
||||
* Some hints about the image loader.
|
||||
*
|
||||
* @VIPS_FORMAT_PARTIAL means that the image can be read directly from the
|
||||
* file without needing to be unpacked to a temporary image first.
|
||||
*
|
||||
* @VIPS_FORMAT_BIGENDIAN means that image pixels are most-significant byte
|
||||
* first. Depending on the native byte order of the host machine, you may
|
||||
* need to swap bytes. See copy_swap().
|
||||
*/
|
||||
|
||||
/**
|
||||
* VipsFormat:
|
||||
*
|
||||
* #VipsFormat has these virtual methods:
|
||||
*
|
||||
* |[
|
||||
* typedef struct _VipsFormatClass {
|
||||
* VipsObjectClass parent_class;
|
||||
*
|
||||
* gboolean (*is_a)( const char *filename );
|
||||
* int (*header)( const char *filename, IMAGE *out );
|
||||
* int (*load)( const char *filename, IMAGE *out );
|
||||
* int (*save)( IMAGE *in, const char *filename );
|
||||
* VipsFormatFlags (*get_flags)( const char *filename );
|
||||
* int priority;
|
||||
* const char **suffs;
|
||||
* } VipsFormatClass;
|
||||
* ]|
|
||||
*
|
||||
* Add a new format to VIPS by subclassing VipsFormat. Subclasses need to
|
||||
* implement at least load() or save().
|
||||
*
|
||||
* These members are:
|
||||
*
|
||||
* <itemizedlist>
|
||||
* <listitem>
|
||||
* <para>
|
||||
* is_a() This function should return %TRUE if the file
|
||||
* contains an image of this type. If you don't define this function, VIPS
|
||||
* will use the list of suffixes you supply instead.
|
||||
* </para>
|
||||
* </listitem>
|
||||
* <listitem>
|
||||
* <para>
|
||||
* header() This function should load the image header,
|
||||
* but not load any pixel data. If you don't define it, VIPS will use your
|
||||
* load() method instead. Return 0 for success, -1 for error, setting
|
||||
* vips_error().
|
||||
* </para>
|
||||
* </listitem>
|
||||
* <listitem>
|
||||
* <para>
|
||||
* load() This function should load the image, or perhaps use
|
||||
* vips_image_generate() to
|
||||
* attach something to load sections of the image on demand.
|
||||
* Users can embed
|
||||
* load options in the filename, see (for example) im_jpeg2vips().
|
||||
* If you don't
|
||||
* define this method, you can still define save() and have a save-only
|
||||
* format.
|
||||
* Return 0 for success, -1 for error, setting
|
||||
* im_error().
|
||||
* </para>
|
||||
* </listitem>
|
||||
* <listitem>
|
||||
* <para>
|
||||
* save() This function should save the image to the file.
|
||||
* Users can embed
|
||||
* save options in the filename, see (for example) im_vips2tiff().
|
||||
* If you don't
|
||||
* define this method, you can still define load() and have a load-only
|
||||
* format.
|
||||
* Return 0 for success, -1 for error, setting
|
||||
* im_error().
|
||||
* </para>
|
||||
* </listitem>
|
||||
* <listitem>
|
||||
* <para>
|
||||
* get_flags() This function should return a hint about the properties of this
|
||||
* loader on this file. If you don't define it, users will always see '0', or
|
||||
* no flags.
|
||||
* </para>
|
||||
* </listitem>
|
||||
* <listitem>
|
||||
* <para>
|
||||
* <structfield>priority</structfield> Where this format should fit in this
|
||||
* list of
|
||||
* supported formats. 0 is a sensible value for most formats. Set a negative
|
||||
* value if you want to be lower on the list, positive to move up.
|
||||
* </para>
|
||||
* </listitem>
|
||||
* <listitem>
|
||||
* <para>
|
||||
* <structfield>suffs</structfield> A %NULL-terminated list of possible file
|
||||
* name
|
||||
* suffixes, for example:
|
||||
* |[
|
||||
* static const char *tiff_suffs[] = { ".tif", ".tiff", NULL };
|
||||
* ]|
|
||||
* The suffix list is used to select a format to save a file in, and to pick a
|
||||
* loader if you don't define is_a().
|
||||
* </para>
|
||||
* </listitem>
|
||||
* </itemizedlist>
|
||||
*
|
||||
* You should also define <structfield>nickname</structfield> and
|
||||
* <structfield>description</structfield> in #VipsObject.
|
||||
*
|
||||
* At the command-line, use:
|
||||
*
|
||||
* |[
|
||||
* vips --list classes | grep Format
|
||||
* ]|
|
||||
*
|
||||
* To see a list of all the supported formats.
|
||||
*
|
||||
* For example, the TIFF format is defined like this:
|
||||
*
|
||||
|[
|
||||
typedef VipsFormat VipsFormatTiff;
|
||||
typedef VipsFormatClass VipsFormatTiffClass;
|
||||
|
||||
static void
|
||||
vips_format_tiff_class_init( VipsFormatTiffClass *class )
|
||||
{
|
||||
VipsObjectClass *object_class = (VipsObjectClass *) class;
|
||||
VipsFormatClass *format_class = (VipsFormatClass *) class;
|
||||
|
||||
object_class->nickname = "tiff";
|
||||
object_class->description = _( "TIFF" );
|
||||
|
||||
format_class->is_a = istiff;
|
||||
format_class->header = tiff2vips_header;
|
||||
format_class->load = im_tiff2vips;
|
||||
format_class->save = im_vips2tiff;
|
||||
format_class->get_flags = tiff_flags;
|
||||
format_class->suffs = tiff_suffs;
|
||||
}
|
||||
|
||||
static void
|
||||
vips_format_tiff_init( VipsFormatTiff *object )
|
||||
{
|
||||
}
|
||||
|
||||
G_DEFINE_TYPE( VipsFormatTiff, vips_format_tiff, VIPS_TYPE_FORMAT );
|
||||
]|
|
||||
*
|
||||
* Then call vips_format_tiff_get_type() somewhere in your init code to link
|
||||
* the format into VIPS (though of course the tiff format is linked in for you
|
||||
* already).
|
||||
*
|
||||
*/
|
||||
|
||||
/* To iterate over supported formats, we build a temp list of subclasses of
|
||||
* VipsFormat, sort by priority, iterate, and free.
|
||||
*/
|
||||
|
||||
static void *
|
||||
format_add_class( VipsFormatClass *format, GSList **formats )
|
||||
{
|
||||
/* Append so we don't reverse the list of formats.
|
||||
*/
|
||||
*formats = g_slist_append( *formats, format );
|
||||
|
||||
return( NULL );
|
||||
}
|
||||
|
||||
static gint
|
||||
format_compare( VipsFormatClass *a, VipsFormatClass *b )
|
||||
{
|
||||
return( b->priority - a->priority );
|
||||
}
|
||||
|
||||
/**
|
||||
* vips_format_map:
|
||||
* @base: base class to search below (eg. "VipsFormatLoad")
|
||||
* @fn: function to apply to each #VipsFormatClass
|
||||
* @a: user data
|
||||
* @b: user data
|
||||
*
|
||||
* Apply a function to every #VipsFormatClass that VIPS knows about. Formats
|
||||
* are presented to the function in priority order.
|
||||
*
|
||||
* Like all VIPS map functions, if @fn returns %NULL, iteration continues. If
|
||||
* it returns non-%NULL, iteration terminates and that value is returned. The
|
||||
* map function returns %NULL if all calls return %NULL.
|
||||
*
|
||||
* See also: vips_slist_map().
|
||||
*
|
||||
* Returns: the result of iteration
|
||||
*/
|
||||
void *
|
||||
vips_format_map( const char *base, VipsSListMap2Fn fn, void *a, void *b )
|
||||
{
|
||||
GSList *formats;
|
||||
void *result;
|
||||
|
||||
formats = NULL;
|
||||
(void) vips_class_map_all( g_type_from_name( base ),
|
||||
(VipsClassMapFn) format_add_class, (void *) &formats );
|
||||
|
||||
formats = g_slist_sort( formats, (GCompareFunc) format_compare );
|
||||
result = vips_slist_map2( formats, fn, a, b );
|
||||
g_slist_free( formats );
|
||||
|
||||
return( result );
|
||||
}
|
||||
|
||||
/* Abstract base class for image formats.
|
||||
*/
|
||||
|
||||
G_DEFINE_ABSTRACT_TYPE( VipsFormat, vips_format, VIPS_TYPE_OBJECT );
|
||||
|
||||
static void
|
||||
vips_format_print_class( VipsObjectClass *object_class, VipsBuf *buf )
|
||||
{
|
||||
VipsFormatClass *class = VIPS_FORMAT_CLASS( object_class );
|
||||
const char **p;
|
||||
|
||||
VIPS_OBJECT_CLASS( vips_format_parent_class )->
|
||||
print_class( object_class, buf );
|
||||
vips_buf_appends( buf, ", " );
|
||||
|
||||
if( class->suffs ) {
|
||||
vips_buf_appends( buf, "(" );
|
||||
for( p = class->suffs; *p; p++ ) {
|
||||
vips_buf_appendf( buf, "%s", *p );
|
||||
if( p[1] )
|
||||
vips_buf_appends( buf, ", " );
|
||||
}
|
||||
vips_buf_appends( buf, ") " );
|
||||
}
|
||||
|
||||
vips_buf_appends( buf, "priority=%d ", class->priority );
|
||||
|
||||
if( class->is_a )
|
||||
vips_buf_appends( buf, "is_a " );
|
||||
}
|
||||
|
||||
static void
|
||||
vips_format_class_init( VipsFormatClass *class )
|
||||
{
|
||||
VipsObjectClass *object_class = (VipsObjectClass *) class;
|
||||
|
||||
object_class->nickname = "format";
|
||||
object_class->description = _( "file format support" );
|
||||
object_class->print_class = vips_format_print_class;
|
||||
|
||||
VIPS_ARG_STRING( class, "filename", 12,
|
||||
_( "Filename" ),
|
||||
_( "Format filename" ),
|
||||
VIPS_ARGUMENT_REQUIRED_INPUT,
|
||||
G_STRUCT_OFFSET( VipsFormat, filename ),
|
||||
NULL );
|
||||
}
|
||||
|
||||
static void
|
||||
vips_format_init( VipsFormat *object )
|
||||
{
|
||||
}
|
||||
|
||||
/* Abstract base class for image load.
|
||||
*/
|
||||
|
||||
G_DEFINE_ABSTRACT_TYPE( VipsFormatLoad, vips_formats_load, VIPS_TYPE_FORMAT );
|
||||
|
||||
static void
|
||||
vips_format_load_print_class( VipsObjectClass *object_class, VipsBuf *buf )
|
||||
{
|
||||
VipsFormatLoadClass *class = VIPS_FORMAT_LOAD_CLASS( object_class );
|
||||
const char **p;
|
||||
|
||||
VIPS_OBJECT_CLASS( vips_format_load_parent_class )->
|
||||
print_class( object_class, buf );
|
||||
vips_buf_appends( buf, ", " );
|
||||
|
||||
if( class->header )
|
||||
vips_buf_appends( buf, "header " );
|
||||
if( class->load )
|
||||
vips_buf_appends( buf, "load " );
|
||||
if( class->get_flags )
|
||||
vips_buf_appends( buf, "get_flags " );
|
||||
}
|
||||
|
||||
static int
|
||||
vips_format_load_build( VipsObject *object )
|
||||
{
|
||||
VipsFormat *format = VIPS_FORMAT( object );
|
||||
VipsFormatLoad *load = VIPS_FORMAT_LOAD( object );
|
||||
|
||||
g_object_set( object, "out", vips_image_new(), NULL );
|
||||
|
||||
if( VIPS_OBJECT_CLASS( vips_format_load_parent_class )->
|
||||
build( object ) )
|
||||
return( -1 );
|
||||
|
||||
return( 0 );
|
||||
}
|
||||
|
||||
static void
|
||||
vips_format_load_class_init( VipsFormatLoadClass *class )
|
||||
{
|
||||
VipsObjectClass *object_class = (VipsObjectClass *) class;
|
||||
|
||||
object_class->nickname = "formatload";
|
||||
object_class->description = _( "format loaders" );
|
||||
object_class->print_class = vips_format_load_print_class;
|
||||
object_class->build = vips_format_load_build;
|
||||
|
||||
VIPS_ARG_ENUM( class, "flags", 6,
|
||||
_( "Flags" ),
|
||||
_( "Flags for this format" ),
|
||||
VIPS_ARGUMENT_OPTIONAL_OUTPUT,
|
||||
G_STRUCT_OFFSET( VipsFormatLoad, flags ),
|
||||
VIPS_TYPE_FORMAT_FLAGS, VIPS_FORMAT_NONE );
|
||||
|
||||
VIPS_ARG_IMAGE( class, "out", 1,
|
||||
_( "Output" ),
|
||||
_( "Output image" ),
|
||||
VIPS_ARGUMENT_REQUIRED_OUTPUT,
|
||||
G_STRUCT_OFFSET( VipsFormatLoad, out ) );
|
||||
|
||||
}
|
||||
|
||||
static void
|
||||
vips_format_load_init( VipsFormatLoad *object )
|
||||
{
|
||||
}
|
||||
|
||||
/* Can this format open this file?
|
||||
*/
|
||||
static void *
|
||||
vips_format_load_new_from_file_sub( VipsFormatLoadClass *load_class,
|
||||
const char *filename )
|
||||
{
|
||||
if( load_class->is_a ) {
|
||||
if( load_class->is_a( filename ) )
|
||||
return( load_class );
|
||||
}
|
||||
else if( vips_filename_suffix_match( filename, load_class->suffs ) )
|
||||
return( load_class );
|
||||
|
||||
return( NULL );
|
||||
}
|
||||
|
||||
/**
|
||||
* vips_format_load_new_from_file:
|
||||
* @filename: file to find a format for
|
||||
*
|
||||
* Searches for a format you could use to load a file. Set some more options
|
||||
* after this, then call _build() to actually load in the file.
|
||||
*
|
||||
* See also: vips_format_read(), vips_format_for_name().
|
||||
*
|
||||
* Returns: a format on success, %NULL on error
|
||||
*/
|
||||
VipsFormatLoad *
|
||||
vips_format_load_new_from_file( const char *filename )
|
||||
{
|
||||
VipsFormatLoadClass *load_class;
|
||||
VipsFormatLoad *load;
|
||||
|
||||
if( !vips_existsf( "%s", filename ) ) {
|
||||
vips_error( "VipsFormatLoad",
|
||||
_( "file \"%s\" not found" ), filename );
|
||||
return( NULL );
|
||||
}
|
||||
|
||||
if( !(load_class = (VipsFormatLoadClass *) vips_format_map(
|
||||
"VipsFormatLoad",
|
||||
(VipsSListMap2Fn) vips_format_load_new_from_file_sub,
|
||||
(void *) filename, NULL )) ) {
|
||||
vips_error( "VipsFormatLoad",
|
||||
_( "file \"%s\" not a known format" ), name );
|
||||
return( NULL );
|
||||
}
|
||||
|
||||
load = VIPS_FORMAT_LOAD(
|
||||
g_object_new( G_TYPE_FROM_CLASS( load_class ), NULL ) );
|
||||
|
||||
/* May as well set flags here, should be quick.
|
||||
*/
|
||||
if( load_class->get_flags )
|
||||
g_object_set( load,
|
||||
"flags", load_class->get_flags( load ),
|
||||
NULL );
|
||||
|
||||
return( load );
|
||||
}
|
||||
|
||||
/* Abstract base class for image savers.
|
||||
*/
|
||||
|
||||
G_DEFINE_ABSTRACT_TYPE( VipsFormatSave, vips_format_save, VIPS_TYPE_FORMAT );
|
||||
|
||||
static void
|
||||
vips_format_save_print_class( VipsObjectClass *object_class, VipsBuf *buf )
|
||||
{
|
||||
VipsFormatSaveClass *class = VIPS_FORMAT_SAVE_CLASS( object_class );
|
||||
const char **p;
|
||||
|
||||
VIPS_OBJECT_CLASS( vips_format_save_parent_class )->
|
||||
print_class( object_class, buf );
|
||||
vips_buf_appends( buf, ", " );
|
||||
|
||||
if( class->save )
|
||||
vips_buf_appends( buf, "save " );
|
||||
}
|
||||
|
||||
static int
|
||||
vips_format_save_build( VipsObject *object )
|
||||
{
|
||||
VipsFormat *format = VIPS_FORMAT( object );
|
||||
VipsFormatSave *save = VIPS_FORMAT_SAVE( object );
|
||||
|
||||
if( VIPS_OBJECT_CLASS( vips_format_save_parent_class )->
|
||||
build( object ) )
|
||||
return( -1 );
|
||||
|
||||
return( 0 );
|
||||
}
|
||||
|
||||
static void
|
||||
vips_format_save_class_init( VipsFormatSaveClass *class )
|
||||
{
|
||||
VipsObjectClass *object_class = (VipsObjectClass *) class;
|
||||
|
||||
object_class->nickname = "formatsave";
|
||||
object_class->description = _( "format savers" );
|
||||
object_class->print_class = vips_format_save_print_class;
|
||||
object_class->build = vips_format_save_build;
|
||||
|
||||
VIPS_ARG_IMAGE( class, "in", 1,
|
||||
_( "Input" ),
|
||||
_( "Image to save" ),
|
||||
VIPS_ARGUMENT_REQUIRED_INPUT,
|
||||
G_STRUCT_OFFSET( VipsFormatSave, in ) );
|
||||
}
|
||||
|
||||
static void
|
||||
vips_format_save_init( VipsFormat *object )
|
||||
{
|
||||
}
|
||||
|
||||
/* Can we write this filename with this format?
|
||||
*/
|
||||
static void *
|
||||
vips_format_save_new_from_filename_sub( VipsFormatSaveClass *save_class,
|
||||
const char *filename )
|
||||
{
|
||||
VipsFormatClass *format = VIPS_FORMAT_CLASS( save_class );
|
||||
|
||||
if( save_class->save &&
|
||||
vips_filename_suffix_match( filename, format->suffs ) )
|
||||
return( save_class );
|
||||
|
||||
return( NULL );
|
||||
}
|
||||
|
||||
/**
|
||||
* vips_format_save_new_from_filename:
|
||||
* @filename: name to find a format for
|
||||
*
|
||||
* Searches for a format you could use to save a file.
|
||||
*
|
||||
* See also: vips_format_write(), vips_format_for_file().
|
||||
*
|
||||
* Returns: a format on success, %NULL on error
|
||||
*/
|
||||
VipsFormatSave *
|
||||
vips_format_save_new_from_filename( const char *filename )
|
||||
{
|
||||
VipsFormatSaveClass *save_class;
|
||||
VipsFormatSave *save;
|
||||
|
||||
if( !(save_class = (VipsFormatSaveClass *) vips_format_map(
|
||||
"VipsFormatSave",
|
||||
(VipsSListMap2Fn) vips_format_save_new_from_filename_sub,
|
||||
(void *) filename, NULL )) ) {
|
||||
vips_error( "VipsFormatSave",
|
||||
_( "\"%s\" is not a supported image format." ),
|
||||
filename );
|
||||
|
||||
return( NULL );
|
||||
}
|
||||
|
||||
save = VIPS_FORMAT_SAVE(
|
||||
g_object_new( G_TYPE_FROM_CLASS( save_class ), NULL ) );
|
||||
|
||||
return( save );
|
||||
}
|
||||
|
||||
/**
|
||||
* vips_format_read:
|
||||
* @filename: file to load
|
||||
* @out: write the file to this image
|
||||
*
|
||||
* Searches for a format for this file, then loads the file into @out.
|
||||
*
|
||||
* See also: vips_format_write().
|
||||
*
|
||||
* Returns: 0 on success, -1 on error
|
||||
*/
|
||||
int
|
||||
vips_format_read( const char *filename, VipsImage *out )
|
||||
{
|
||||
VipsFormatLoad *load;
|
||||
|
||||
if( !(load = vips_format_load_new_from_file( filename )) )
|
||||
return( -1 );
|
||||
g_object_unref( load );
|
||||
|
||||
return( 0 );
|
||||
}
|
||||
|
||||
/**
|
||||
* vips_format_write:
|
||||
* @in: image to write
|
||||
* @filename: file to write to
|
||||
*
|
||||
* Searches for a format for this name, then saves @im to it.
|
||||
*
|
||||
* See also: vips_format_read().
|
||||
*
|
||||
* Returns: 0 on success, -1 on error
|
||||
*/
|
||||
int
|
||||
vips_format_write( IMAGE *in, const char *filename )
|
||||
{
|
||||
VipsFormatClass *format;
|
||||
|
||||
if( !(format = vips_format_for_name( filename )) ||
|
||||
format->save( in, filename ) )
|
||||
return( -1 );
|
||||
|
||||
return( 0 );
|
||||
}
|
||||
|
@ -14,6 +14,7 @@ pkginclude_HEADERS = \
|
||||
error.h \
|
||||
operation.h \
|
||||
format.h \
|
||||
file.h \
|
||||
inplace.h \
|
||||
generate.h \
|
||||
header.h \
|
||||
|
196
libvips/include/vips/file.h
Normal file
196
libvips/include/vips/file.h
Normal file
@ -0,0 +1,196 @@
|
||||
/* Base type for supported image files. Subclass this to add a new
|
||||
* file.
|
||||
*/
|
||||
|
||||
/*
|
||||
|
||||
This file is part of VIPS.
|
||||
|
||||
VIPS is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU Lesser General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program 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 Lesser General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU Lesser General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
|
||||
*/
|
||||
|
||||
/*
|
||||
|
||||
These files are distributed with VIPS - http://www.vips.ecs.soton.ac.uk
|
||||
|
||||
*/
|
||||
|
||||
#ifndef IM_FILE_H
|
||||
#define IM_FILE_H
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif /*__cplusplus*/
|
||||
|
||||
#define VIPS_TYPE_FILE (vips_file_get_type())
|
||||
#define VIPS_FILE( obj ) \
|
||||
(G_TYPE_CHECK_INSTANCE_CAST( (obj), \
|
||||
VIPS_TYPE_FILE, VipsFile ))
|
||||
#define VIPS_FILE_CLASS( klass ) \
|
||||
(G_TYPE_CHECK_CLASS_CAST( (klass), \
|
||||
VIPS_TYPE_FILE, VipsFileClass))
|
||||
#define VIPS_IS_FILE( obj ) \
|
||||
(G_TYPE_CHECK_INSTANCE_TYPE( (obj), VIPS_TYPE_FILE ))
|
||||
#define VIPS_IS_FILE_CLASS( klass ) \
|
||||
(G_TYPE_CHECK_CLASS_TYPE( (klass), VIPS_TYPE_FILE ))
|
||||
#define VIPS_FILE_GET_CLASS( obj ) \
|
||||
(G_TYPE_INSTANCE_GET_CLASS( (obj), \
|
||||
VIPS_TYPE_FILE, VipsFileClass ))
|
||||
|
||||
typedef struct _VipsFile {
|
||||
VipsOperation parent_object;
|
||||
/*< public >*/
|
||||
|
||||
/* Filename for load or save.
|
||||
*/
|
||||
char *filename;
|
||||
|
||||
} VipsFile;
|
||||
|
||||
typedef struct _VipsFileClass {
|
||||
VipsOperationClass parent_class;
|
||||
|
||||
/*< public >*/
|
||||
/* Is a file in this file.
|
||||
*/
|
||||
gboolean (*is_a)( const char * );
|
||||
|
||||
/* Null-terminated list of allowed suffixes, eg. ".tif", ".tiff".
|
||||
*/
|
||||
const char **suffs;
|
||||
|
||||
/* Loop over files in this order, default 0. We need this because
|
||||
* some files can be read by several loaders (eg. tiff can be read
|
||||
* by the libMagick loader as well as by the tiff loader), and we want
|
||||
* to make sure the better loader comes first.
|
||||
*/
|
||||
int priority;
|
||||
|
||||
} VipsFileClass;
|
||||
|
||||
GType vips_file_get_type( void );
|
||||
|
||||
/* Map over and find files. This uses type introspection to loop over
|
||||
* subclasses of VipsFile.
|
||||
*/
|
||||
void *vips_file_map( VipsSListMap2Fn fn, void *a, void *b );
|
||||
|
||||
#define VIPS_TYPE_FILE_LOAD (vips_file_load_get_type())
|
||||
#define VIPS_FILE_LOAD( obj ) \
|
||||
(G_TYPE_CHECK_INSTANCE_CAST( (obj), \
|
||||
VIPS_TYPE_FILE_LOAD, VipsFileLoad ))
|
||||
#define VIPS_FILE_LOAD_CLASS( klass ) \
|
||||
(G_TYPE_CHECK_CLASS_CAST( (klass), \
|
||||
VIPS_TYPE_FILE_LOAD, VipsFileLoadClass))
|
||||
#define VIPS_IS_FILE_LOAD( obj ) \
|
||||
(G_TYPE_CHECK_INSTANCE_TYPE( (obj), VIPS_TYPE_FILE_LOAD ))
|
||||
#define VIPS_IS_FILE_LOAD_CLASS( klass ) \
|
||||
(G_TYPE_CHECK_CLASS_TYPE( (klass), VIPS_TYPE_FILE_LOAD ))
|
||||
#define VIPS_FILE_LOAD_GET_CLASS( obj ) \
|
||||
(G_TYPE_INSTANCE_GET_CLASS( (obj), \
|
||||
VIPS_TYPE_FILE_LOAD, VipsFileLoadClass ))
|
||||
|
||||
/* Image file properties.
|
||||
*/
|
||||
typedef enum {
|
||||
VIPS_FILE_NONE = 0, /* No flags set */
|
||||
VIPS_FILE_PARTIAL = 1, /* Lazy read OK (eg. tiled tiff) */
|
||||
VIPS_FILE_BIGENDIAN = 2 /* Most-significant byte first */
|
||||
} VipsFileFlags;
|
||||
|
||||
typedef struct _VipsFileLoad {
|
||||
VipsFile parent_object;
|
||||
/*< public >*/
|
||||
|
||||
/* Flags read from the file.
|
||||
*/
|
||||
VipsFileFlags flags;
|
||||
|
||||
/* The image we've loaded.
|
||||
*/
|
||||
VipsImage *out;
|
||||
|
||||
} VipsFileLoad;
|
||||
|
||||
typedef struct _VipsFileLoadClass {
|
||||
VipsFileClass parent_class;
|
||||
|
||||
/*< public >*/
|
||||
|
||||
/* Get the flags for this file in this file.
|
||||
*/
|
||||
VipsFileFlags (*get_flags)( VipsFileLoad * );
|
||||
|
||||
} VipsFileLoadClass;
|
||||
|
||||
GType vips_file_load_get_type( void );
|
||||
|
||||
VipsFileLoad *vips_file_load_new_from_file( const char *filename );
|
||||
|
||||
VipsFileLoad *vips_file_for_file( const char *filename );
|
||||
|
||||
#define VIPS_TYPE_FILE_SAVE (vips_file_save_get_type())
|
||||
#define VIPS_FILE_SAVE( obj ) \
|
||||
(G_TYPE_CHECK_INSTANCE_CAST( (obj), \
|
||||
VIPS_TYPE_FILE_SAVE, VipsFileSave ))
|
||||
#define VIPS_FILE_SAVE_CLASS( klass ) \
|
||||
(G_TYPE_CHECK_CLASS_CAST( (klass), \
|
||||
VIPS_TYPE_FILE_SAVE, VipsFileSaveClass))
|
||||
#define VIPS_IS_FILE_SAVE( obj ) \
|
||||
(G_TYPE_CHECK_INSTANCE_TYPE( (obj), VIPS_TYPE_FILE_SAVE ))
|
||||
#define VIPS_IS_FILE_SAVE_CLASS( klass ) \
|
||||
(G_TYPE_CHECK_CLASS_TYPE( (klass), VIPS_TYPE_FILE_SAVE ))
|
||||
#define VIPS_FILE_SAVE_GET_CLASS( obj ) \
|
||||
(G_TYPE_INSTANCE_GET_CLASS( (obj), \
|
||||
VIPS_TYPE_FILE_SAVE, VipsFileSaveClass ))
|
||||
|
||||
typedef struct _VipsFileSave {
|
||||
VipsFile parent_object;
|
||||
/*< public >*/
|
||||
|
||||
/* The image we are to save.
|
||||
*/
|
||||
VipsImage *in;
|
||||
|
||||
} VipsFileSave;
|
||||
|
||||
typedef struct _VipsFileSaveClass {
|
||||
VipsFileClass parent_class;
|
||||
|
||||
/*< public >*/
|
||||
|
||||
} VipsFileSaveClass;
|
||||
|
||||
GType vips_file_save_get_type( void );
|
||||
|
||||
VipsFileSave *vips_file_save_new_from_filename( const char *filename )
|
||||
|
||||
/* Read/write an image convenience functions.
|
||||
*/
|
||||
int vips_file_read( const char *filename, VipsImage *out );
|
||||
int vips_file_write( VipsImage *in, const char *filename );
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif /*__cplusplus*/
|
||||
|
||||
#endif /*IM_FILE_H*/
|
@ -108,6 +108,7 @@ extern "C" {
|
||||
#include <vips/image.h>
|
||||
#include <vips/memory.h>
|
||||
#include <vips/error.h>
|
||||
#include <vips/file.h>
|
||||
#include <vips/format.h>
|
||||
#include <vips/region.h>
|
||||
#include <vips/generate.h>
|
||||
|
Loading…
Reference in New Issue
Block a user