b885e90eb9
* Added \since to each method and parameter. * Whitespace cleanup. * Some other minor cleanups and updates.
244 lines
7.1 KiB
Plaintext
244 lines
7.1 KiB
Plaintext
/*
|
|
* Copyright 2013-2014 Haiku, Inc. All rights reserved.
|
|
* Distributed under the terms of the MIT License.
|
|
*
|
|
* Authors:
|
|
* Ingo Weinhold, bonefish@users.sf.net
|
|
* John Scipione, jscipione@gmail.com
|
|
*
|
|
* Corresponds to:
|
|
* headers/os/storage/Mime.h hrev47402
|
|
* src/kits/storage/Mime.cpp hrev47402
|
|
*/
|
|
|
|
|
|
/*!
|
|
\file Mime.h
|
|
\ingroup storage
|
|
\ingroup libbe
|
|
\brief Provides C and Haiku-only C++ MIME-type handling functions.
|
|
*/
|
|
|
|
|
|
/*!
|
|
\enum icon_size
|
|
\ingroup storage
|
|
\brief Legacy BeOS icon size constants.
|
|
|
|
\since BeOS R3
|
|
*/
|
|
|
|
|
|
/*!
|
|
\var icon_size B_LARGE_ICON
|
|
|
|
32x32 "Large" icon.
|
|
|
|
\since BeOS R3
|
|
*/
|
|
|
|
|
|
/*!
|
|
\var icon_size B_MINI_ICON
|
|
|
|
16x16 "Mini" icon.
|
|
|
|
\since BeOS R3
|
|
*/
|
|
|
|
|
|
/*!
|
|
\var B_UPDATE_MIME_INFO_NO_FORCE
|
|
\brief Files that already have a \c BEOS:TYPE attribute won't be updated.
|
|
|
|
\since Haiku R1
|
|
*/
|
|
|
|
|
|
/*!
|
|
\var B_UPDATE_MIME_INFO_FORCE_KEEP_TYPE
|
|
\brief Files that already have a \c BEOS:TYPE attribute will be updated
|
|
too, but \c BEOS:TYPE itself will remain untouched.
|
|
|
|
\since Haiku R1
|
|
*/
|
|
|
|
|
|
/*!
|
|
\var B_UPDATE_MIME_INFO_FORCE_UPDATE_ALL
|
|
\brief Similar to \c B_UPDATE_MIME_INFO_FORCE_KEEP_TYPE, but the
|
|
\c BEOS:TYPE attribute will be updated too.
|
|
|
|
\since Haiku R1
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn int update_mime_info(const char* path, int recursive, int synchronous,
|
|
int force)
|
|
\brief Updates the MIME information (i.e MIME type) for one or more files.
|
|
|
|
If \a path points to a file, the MIME information for this file are
|
|
updated only. If it points to a directory and \a recursive is non-null,
|
|
the information for all the files in the given directory tree are updated.
|
|
If path is \c NULL all files are considered; \a recursive is ignored in
|
|
this case.
|
|
|
|
\param path The path to a file or directory, or \c NULL.
|
|
\param recursive Triggers recursive behavior if not \c NULL.
|
|
\param synchronous If not \c NULL update_mime_info() waits until the
|
|
operation is finished, otherwise it returns immediately and the
|
|
update is done asynchronously.
|
|
\param force Specifies how to handle files that already have MIME
|
|
information. See enum definitions for more information:
|
|
- \c B_UPDATE_MIME_INFO_NO_FORCE
|
|
- \c B_UPDATE_MIME_INFO_FORCE_KEEP_TYPE
|
|
- \c B_UPDATE_MIME_INFO_FORCE_UPDATE_ALL
|
|
|
|
\return A status code, \c B_OK if everything went fine, an error code
|
|
otherwise.
|
|
|
|
\since BeOS R3
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn status_t create_app_meta_mime(const char* path, int recursive,
|
|
int synchronous, int force)
|
|
\brief Creates a MIME database entry for one or more applications.
|
|
|
|
If \a path points to an application file, a MIME DB entry is create for
|
|
the application. If it points to a directory and \a recursive is not
|
|
\c NULL then entries are created for all application files in the given
|
|
directory tree. If path is \c NULL then all files are considered and
|
|
\a recursive is ignored.
|
|
|
|
\param path The path to an application file, a directory, or \c NULL.
|
|
\param recursive Trigger recursive behavior if not \c NULL.
|
|
\param synchronous Waits until the operation is finished if not \c NULL,
|
|
otherwise it returns immediately and the operation is done
|
|
asynchronously.
|
|
\param force Entries are created even if they do already exist if not
|
|
\c NULL.
|
|
|
|
\return A status code, \c B_OK if everything went fine, an error code
|
|
otherwise.
|
|
|
|
\since BeOS R3
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn status_t get_device_icon(const char* device, void* icon, int32 size)
|
|
\brief Retrieves an icon associated with a given device.
|
|
|
|
\param device The path to the device.
|
|
\param icon A pointer to a buffer the icon data shall be written to.
|
|
\param size The size of the icon to retrieve. Currently 16
|
|
(\c B_MINI_ICON) and 32 (\c B_LARGE_ICON) are supported.
|
|
|
|
\return A status code, \c B_OK if everything went fine, an error code
|
|
otherwise.
|
|
\retval B_OK Retrieved the icon successfully.
|
|
\retval B_BAD_VALUE \a device or \a icon was \c NULL.
|
|
\retval B_NO_MEMORY Ran out of memory allocating bitmap.
|
|
|
|
\since BeOS R3
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn status_t get_device_icon(const char* device, BBitmap* icon,
|
|
icon_size which)
|
|
\brief Retrieves an icon associated with a given device into a BBitmap,
|
|
C++ only.
|
|
|
|
\param device The path to the device.
|
|
\param icon A pointer to a pre-allocated BBitmap of the correct dimension
|
|
to store the requested icon (16x16 for the mini and 32x32 for the
|
|
large icon).
|
|
\param which The size of the icon to retrieve. Currently 16
|
|
(\c B_MINI_ICON) and 32 (\c B_LARGE_ICON) are supported.
|
|
|
|
\return A status code, \c B_OK if everything went fine, an error code
|
|
otherwise.
|
|
\retval B_OK Retrieved the icon successfully.
|
|
\retval B_BAD_VALUE \a device or \a icon was \c NULL.
|
|
|
|
\since Haiku R1
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn status_t get_device_icon(const char* device, uint8** _data,
|
|
size_t* _size, type_code* _type);
|
|
\brief Try to get the icon by name first, if that fails try to get the
|
|
vector icon, C++ only.
|
|
|
|
\param device The path to the device.
|
|
\param _data A pointer to a pointer to an array of uint8 pixel data to
|
|
fill out.
|
|
\param _size The size of the icon to fill out. If vector, it is filled in
|
|
with the width in pixels, if bitmap, one of the following constants:
|
|
- \c B_MINI_ICON
|
|
- \c B_LARGE_ICON
|
|
\param _type The icon type code to fill out, one of the following:
|
|
- \c B_MINI_ICON_TYPE
|
|
- \c B_LARGE_ICON_TYPE
|
|
- \c B_VECTOR_ICON_TYPE
|
|
|
|
\return A status code, \c B_OK if everything went fine, an error code
|
|
otherwise.
|
|
\retval B_OK Retrieved the icon successfully.
|
|
\retval B_BAD_VALUE \a device, \a _data, \a _size, or _type was \c NULL.
|
|
|
|
\since Haiku R1
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn status_t get_named_icon(const char* name, BBitmap* icon,
|
|
icon_size which);
|
|
\brief Get the icon by name, C++ only.
|
|
|
|
\param name The name of the icon to get.
|
|
\param icon A pointer to a pre-allocated BBitmap of the correct dimension
|
|
to store the requested icon (16x16 for the mini and 32x32 for the
|
|
large icon).
|
|
\param which The size of the icon to retrieve. Currently 16
|
|
(\c B_MINI_ICON) and 32 (\c B_LARGE_ICON) are supported.
|
|
|
|
\return A status code, \c B_OK if everything went fine, an error code
|
|
otherwise.
|
|
\retval B_OK Retrieved the icon successfully.
|
|
\retval B_BAD_VALUE \a name or \a icon was \c NULL.
|
|
|
|
\since Haiku R1
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn status_t get_named_icon(const char* name, uint8** _data,
|
|
size_t* _size, type_code* _type);
|
|
\brief Get the icon by name, C++ only.
|
|
|
|
\param name The name of the icon to get.
|
|
\param _data A pointer to a pointer to an array of uint8 pixel data to
|
|
fill out.
|
|
\param _size The size of the icon to fill out. If vector, it is filled in
|
|
with the width in pixels, if bitmap, one of the following constants:
|
|
- \c B_MINI_ICON
|
|
- \c B_LARGE_ICON
|
|
\param _type The icon type code to fill out, one of the following:
|
|
- \c B_MINI_ICON_TYPE
|
|
- \c B_LARGE_ICON_TYPE
|
|
- \c B_VECTOR_ICON_TYPE
|
|
|
|
\return A status code, \c B_OK if everything went fine, an error code
|
|
otherwise.
|
|
\retval B_OK Retrieved the icon successfully.
|
|
\retval B_BAD_VALUE \a name, \a _data, \a _size, or \c _type was \c NULL.
|
|
|
|
\since Haiku R1
|
|
*/
|