World of Might and Magic
0.2.0
Open reimplementation of Might and Magic 6 7 8 game engine
|
Классы | |
struct | AVIOInterruptCB |
struct | AVIODirEntry |
struct | AVIODirContext |
struct | AVIOContext |
Определения типов | |
typedef struct AVIOInterruptCB | AVIOInterruptCB |
typedef struct AVIODirEntry | AVIODirEntry |
typedef struct AVIODirContext | AVIODirContext |
typedef struct AVIOContext | AVIOContext |
Buffered I/O operations
См. определение в файле avio.h
typedef struct AVIOInterruptCB AVIOInterruptCB |
Callback for checking whether to abort blocking functions. AVERROR_EXIT is returned in this case by the interrupted function. During blocking operations, callback is called with opaque as parameter. If the callback returns 1, the blocking operation will be aborted.
No members can be added to this struct without a major bump, if new elements have been added after this struct in AVFormatContext or AVIOContext.
typedef struct AVIODirEntry AVIODirEntry |
Describes single entry of the directory.
Only name and type fields are guaranteed be set. Rest of fields are protocol or/and platform dependent and might be unknown.
typedef struct AVIODirContext AVIODirContext |
typedef struct AVIOContext AVIOContext |
Bytestream IO Context. New fields can be added to the end with minor version bumps. Removal, reordering and changes to existing fields require a major version bump. sizeof(AVIOContext) must not be used outside libav*.
enum AVIODirEntryType |
Directory entry types.
См. определение в файле avio.h строка 66
enum AVIODataMarkerType |
Different data types that can be returned via the AVIO write_data_type callback.
Элементы перечислений | |
---|---|
AVIO_DATA_MARKER_HEADER | Header data; this needs to be present for the stream to be decodeable. |
AVIO_DATA_MARKER_SYNC_POINT | A point in the output bytestream where a decoder can start decoding (i.e. a keyframe). A demuxer/decoder given the data flagged with AVIO_DATA_MARKER_HEADER, followed by any AVIO_DATA_MARKER_SYNC_POINT, should give decodeable results. |
AVIO_DATA_MARKER_BOUNDARY_POINT | A point in the output bytestream where a demuxer can start parsing (for non self synchronizing bytestream formats). That is, any non-keyframe packet start point. |
AVIO_DATA_MARKER_UNKNOWN | This is any, unlabelled data. It can either be a muxer not marking any positions at all, it can be an actual boundary/sync point that the muxer chooses not to mark, or a later part of a packet/fragment that is cut into multiple write callbacks due to limited IO buffer size. |
AVIO_DATA_MARKER_TRAILER | Trailer data, which doesn't contain actual content, but only for finalizing the output file. |
AVIO_DATA_MARKER_FLUSH_POINT | A point in the output bytestream where the underlying AVIOContext might flush the buffer depending on latency or buffering requirements. Typically means the end of a packet. |
См. определение в файле avio.h строка 111
const char* avio_find_protocol_name | ( | const char * | url | ) |
Return the name of the protocol that will handle the passed URL.
NULL is returned if no protocol could be found for the given URL.
int avio_check | ( | const char * | url, |
int | flags | ||
) |
Return AVIO_FLAG_* access flags corresponding to the access permissions of the resource in url, or a negative value corresponding to an AVERROR code in case of failure. The returned access flags are masked by the value in flags.
int avpriv_io_move | ( | const char * | url_src, |
const char * | url_dst | ||
) |
Move or rename a resource.
url_src | url to resource to be moved |
url_dst | new url to resource if the operation succeeded |
int avpriv_io_delete | ( | const char * | url | ) |
Delete a resource.
url | resource to be deleted. |
int avio_open_dir | ( | AVIODirContext ** | s, |
const char * | url, | ||
AVDictionary ** | options | ||
) |
Open directory for reading.
s | directory read context. Pointer to a NULL pointer must be passed. |
url | directory to be listed. |
options | A dictionary filled with protocol-private options. On return this parameter will be destroyed and replaced with a dictionary containing options that were not found. May be NULL. |
int avio_read_dir | ( | AVIODirContext * | s, |
AVIODirEntry ** | next | ||
) |
Get next directory entry.
Returned entry must be freed with avio_free_directory_entry(). In particular it may outlive AVIODirContext.
s | directory read context. | |
[out] | next | next entry or NULL when no more entries. |
int avio_close_dir | ( | AVIODirContext ** | s | ) |
Close directory.
s | directory read context. |
void avio_free_directory_entry | ( | AVIODirEntry ** | entry | ) |
Free entry allocated by avio_read_dir().
entry | entry to be freed. |
AVIOContext* avio_alloc_context | ( | unsigned char * | buffer, |
int | buffer_size, | ||
int | write_flag, | ||
void * | opaque, | ||
int(*)(void *opaque, uint8_t *buf, int buf_size) | read_packet, | ||
int(*)(void *opaque, uint8_t *buf, int buf_size) | write_packet, | ||
int64_t(*)(void *opaque, int64_t offset, int whence) | seek | ||
) |
Allocate and initialize an AVIOContext for buffered I/O. It must be later freed with avio_context_free().
buffer | Memory block for input/output operations via AVIOContext. The buffer must be allocated with av_malloc() and friends. It may be freed and replaced with a new buffer by libavformat. AVIOContext.buffer holds the buffer currently in use, which must be later freed with av_free(). |
buffer_size | The buffer size is very important for performance. For protocols with fixed blocksize it should be set to this blocksize. For others a typical size is a cache page, e.g. 4kb. |
write_flag | Set to 1 if the buffer should be writable, 0 otherwise. |
opaque | An opaque pointer to user-specific data. |
read_packet | A function for refilling the buffer, may be NULL. For stream protocols, must never return 0 but rather a proper AVERROR code. |
write_packet | A function for writing the buffer contents, may be NULL. The function may not change the input buffers content. |
seek | A function for seeking to specified byte position, may be NULL. |
Используется в Movie::LoadFromLOD() и AudioBufferDataSource::Open().
void avio_context_free | ( | AVIOContext ** | s | ) |
Free the supplied IO context and everything associated with it.
s | Double pointer to the IO context. This function will write NULL into s. |
void avio_w8 | ( | AVIOContext * | s, |
int | b | ||
) |
void avio_write | ( | AVIOContext * | s, |
const unsigned char * | buf, | ||
int | size | ||
) |
void avio_wl64 | ( | AVIOContext * | s, |
uint64_t | val | ||
) |
void avio_wb64 | ( | AVIOContext * | s, |
uint64_t | val | ||
) |
void avio_wl32 | ( | AVIOContext * | s, |
unsigned int | val | ||
) |
void avio_wb32 | ( | AVIOContext * | s, |
unsigned int | val | ||
) |
void avio_wl24 | ( | AVIOContext * | s, |
unsigned int | val | ||
) |
void avio_wb24 | ( | AVIOContext * | s, |
unsigned int | val | ||
) |
void avio_wl16 | ( | AVIOContext * | s, |
unsigned int | val | ||
) |
void avio_wb16 | ( | AVIOContext * | s, |
unsigned int | val | ||
) |
int avio_put_str | ( | AVIOContext * | s, |
const char * | str | ||
) |
Write a NULL-terminated string.
int avio_put_str16le | ( | AVIOContext * | s, |
const char * | str | ||
) |
Convert an UTF-8 string to UTF-16LE and write it.
s | the AVIOContext |
str | NULL-terminated UTF-8 string |
int avio_put_str16be | ( | AVIOContext * | s, |
const char * | str | ||
) |
Convert an UTF-8 string to UTF-16BE and write it.
s | the AVIOContext |
str | NULL-terminated UTF-8 string |
void avio_write_marker | ( | AVIOContext * | s, |
int64_t | time, | ||
enum AVIODataMarkerType | type | ||
) |
Mark the written bytestream as a specific type.
Zero-length ranges are omitted from the output.
time | the stream time the current bytestream pos corresponds to (in AV_TIME_BASE units), or AV_NOPTS_VALUE if unknown or not applicable |
type | the kind of data written starting at the current pos |
int64_t avio_seek | ( | AVIOContext * | s, |
int64_t | offset, | ||
int | whence | ||
) |
fseek() equivalent for AVIOContext.
Используется в avio_tell().
int64_t avio_skip | ( | AVIOContext * | s, |
int64_t | offset | ||
) |
Skip given number of bytes forward
|
static |
ftell() equivalent for AVIOContext.
См. определение в файле avio.h строка 557
Перекрестные ссылки avio_seek().
int64_t avio_size | ( | AVIOContext * | s | ) |
Get the filesize.
int avio_feof | ( | AVIOContext * | s | ) |
Similar to feof() but also returns nonzero on read errors.
int avio_printf | ( | AVIOContext * | s, |
const char * | fmt, | ||
... | |||
) |
int void avio_flush | ( | AVIOContext * | s | ) |
Force flushing of buffered data.
For write streams, force the buffered data to be immediately written to the output, without to wait to fill the internal buffer.
For read streams, discard all currently buffered data, and advance the reported file position to that of the underlying stream. This does not read new data, and does not perform any seeks.
int avio_read | ( | AVIOContext * | s, |
unsigned char * | buf, | ||
int | size | ||
) |
Read size bytes from AVIOContext into buf.
int avio_read_partial | ( | AVIOContext * | s, |
unsigned char * | buf, | ||
int | size | ||
) |
Read size bytes from AVIOContext into buf. Unlike avio_read(), this is allowed to read fewer bytes than requested. The missing bytes can be read in the next call. This always tries to read at least 1 byte. Useful to reduce latency in certain cases.
int avio_r8 | ( | AVIOContext * | s | ) |
unsigned int avio_rl16 | ( | AVIOContext * | s | ) |
unsigned int avio_rl24 | ( | AVIOContext * | s | ) |
unsigned int avio_rl32 | ( | AVIOContext * | s | ) |
uint64_t avio_rl64 | ( | AVIOContext * | s | ) |
unsigned int avio_rb16 | ( | AVIOContext * | s | ) |
unsigned int avio_rb24 | ( | AVIOContext * | s | ) |
unsigned int avio_rb32 | ( | AVIOContext * | s | ) |
uint64_t avio_rb64 | ( | AVIOContext * | s | ) |
int avio_get_str | ( | AVIOContext * | pb, |
int | maxlen, | ||
char * | buf, | ||
int | buflen | ||
) |
Read a string from pb into buf. The reading will terminate when either a NULL character was encountered, maxlen bytes have been read, or nothing more can be read from pb. The result is guaranteed to be NULL-terminated, it will be truncated if buf is too small. Note that the string is not interpreted or validated in any way, it might get truncated in the middle of a sequence for multi-byte encodings.
int avio_get_str16le | ( | AVIOContext * | pb, |
int | maxlen, | ||
char * | buf, | ||
int | buflen | ||
) |
Read a UTF-16 string from pb and convert it to UTF-8. The reading will terminate when either a null or invalid character was encountered or maxlen bytes have been read.
int avio_get_str16be | ( | AVIOContext * | pb, |
int | maxlen, | ||
char * | buf, | ||
int | buflen | ||
) |
int avio_open | ( | AVIOContext ** | s, |
const char * | url, | ||
int | flags | ||
) |
Create and initialize a AVIOContext for accessing the resource indicated by url.
s | Used to return the pointer to the created AVIOContext. In case of failure the pointed to value is set to NULL. |
url | resource to access |
flags | flags which control how the resource indicated by url is to be opened |
int avio_open2 | ( | AVIOContext ** | s, |
const char * | url, | ||
int | flags, | ||
const AVIOInterruptCB * | int_cb, | ||
AVDictionary ** | options | ||
) |
Create and initialize a AVIOContext for accessing the resource indicated by url.
s | Used to return the pointer to the created AVIOContext. In case of failure the pointed to value is set to NULL. |
url | resource to access |
flags | flags which control how the resource indicated by url is to be opened |
int_cb | an interrupt callback to be used at the protocols level |
options | A dictionary filled with protocol-private options. On return this parameter will be destroyed and replaced with a dict containing options that were not found. May be NULL. |
int avio_close | ( | AVIOContext * | s | ) |
Close the resource accessed by the AVIOContext s and free it. This function can only be used if s was opened by avio_open().
The internal buffer is automatically flushed before closing the resource.
int avio_closep | ( | AVIOContext ** | s | ) |
Close the resource accessed by the AVIOContext *s, free it and set the pointer pointing to it to NULL. This function can only be used if s was opened by avio_open().
The internal buffer is automatically flushed before closing the resource.
int avio_open_dyn_buf | ( | AVIOContext ** | s | ) |
Open a write only memory stream.
s | new IO context |
int avio_get_dyn_buf | ( | AVIOContext * | s, |
uint8_t ** | pbuffer | ||
) |
Return the written size and a pointer to the buffer. The AVIOContext stream is left intact. The buffer must NOT be freed. No padding is added to the buffer.
s | IO context |
pbuffer | pointer to a byte buffer |
int avio_close_dyn_buf | ( | AVIOContext * | s, |
uint8_t ** | pbuffer | ||
) |
Return the written size and a pointer to the buffer. The buffer must be freed with av_free(). Padding of AV_INPUT_BUFFER_PADDING_SIZE is added to the buffer.
s | IO context |
pbuffer | pointer to a byte buffer |
const char* avio_enum_protocols | ( | void ** | opaque, |
int | output | ||
) |
Iterate through names of available protocols.
opaque | A private pointer representing current protocol. It must be a pointer to NULL on first iteration and will be updated by successive calls to avio_enum_protocols. |
output | If set to 1, iterate over output protocols, otherwise over input protocols. |
int avio_pause | ( | AVIOContext * | h, |
int | pause | ||
) |
Pause and resume playing - only meaningful if using a network streaming protocol (e.g. MMS).
h | IO context from which to call the read_pause function pointer |
pause | 1 for pause, 0 for resume |
int64_t avio_seek_time | ( | AVIOContext * | h, |
int | stream_index, | ||
int64_t | timestamp, | ||
int | flags | ||
) |
Seek to a given timestamp relative to some component stream. Only meaningful if using a network streaming protocol (e.g. MMS.).
h | IO context from which to call the seek function pointers |
stream_index | The stream index that the timestamp is relative to. If stream_index is (-1) the timestamp should be in AV_TIME_BASE units from the beginning of the presentation. If a stream_index >= 0 is used and the protocol does not support seeking based on component streams, the call will fail. |
timestamp | timestamp in AVStream.time_base units or if there is no stream specified then in AV_TIME_BASE units. |
flags | Optional combination of AVSEEK_FLAG_BACKWARD, AVSEEK_FLAG_BYTE and AVSEEK_FLAG_ANY. The protocol may silently ignore AVSEEK_FLAG_BACKWARD and AVSEEK_FLAG_ANY, but AVSEEK_FLAG_BYTE will fail if used and not supported. |
int avio_read_to_bprint | ( | AVIOContext * | h, |
struct AVBPrint * | pb, | ||
size_t | max_size | ||
) |
Read contents of h into print buffer, up to max_size bytes, or up to EOF.
int avio_accept | ( | AVIOContext * | s, |
AVIOContext ** | c | ||
) |
Accept and allocate a client context on a server context.
s | the server context |
c | the client context, must be unallocated |
int avio_handshake | ( | AVIOContext * | c | ) |
Perform one step of the protocol handshake to accept a new client. This function must be called on a client returned by avio_accept() before using it as a read/write context. It is separate from avio_accept() because it may block. A step of the handshake is defined by places where the application may decide to change the proceedings. For example, on a protocol with a request header and a reply header, each one can constitute a step because the application may use the parameters from the request to change parameters in the reply; or each individual chunk of the request can constitute a step. If the handshake is already finished, avio_handshake() does nothing and returns 0 immediately.
c | the client context to perform the handshake on |