| /* |
| * Copyright 2009, Google Inc. |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions are |
| * met: |
| * |
| * * Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * * Redistributions in binary form must reproduce the above |
| * copyright notice, this list of conditions and the following disclaimer |
| * in the documentation and/or other materials provided with the |
| * distribution. |
| * * Neither the name of Google Inc. nor the names of its |
| * contributors may be used to endorse or promote products derived from |
| * this software without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| |
| // This file contains the command parser class. |
| |
| #ifndef GPU_COMMAND_BUFFER_SERVICE_CROSS_CMD_PARSER_H_ |
| #define GPU_COMMAND_BUFFER_SERVICE_CROSS_CMD_PARSER_H_ |
| |
| #include "gpu/command_buffer/common/constants.h" |
| #include "gpu/command_buffer/common/cmd_buffer_common.h" |
| |
| namespace command_buffer { |
| |
| class AsyncAPIInterface; |
| |
| // Command parser class. This class parses commands from a shared memory |
| // buffer, to implement some asynchronous RPC mechanism. |
| class CommandParser { |
| public: |
| CommandParser(void *shm_address, |
| size_t shm_size, |
| ptrdiff_t offset, |
| size_t size, |
| CommandBufferOffset start_get, |
| AsyncAPIInterface *handler); |
| |
| // Gets the "get" pointer. The get pointer is an index into the command |
| // buffer considered as an array of CommandBufferEntry. |
| CommandBufferOffset get() const { return get_; } |
| |
| // Sets the "put" pointer. The put pointer is an index into the command |
| // buffer considered as an array of CommandBufferEntry. |
| void set_put(CommandBufferOffset put) { put_ = put; } |
| |
| // Gets the "put" pointer. The put pointer is an index into the command |
| // buffer considered as an array of CommandBufferEntry. |
| CommandBufferOffset put() const { return put_; } |
| |
| // Checks whether there are commands to process. |
| bool IsEmpty() const { return put_ == get_; } |
| |
| // Processes one command, updating the get pointer. This will return an error |
| // if there are no commands in the buffer. |
| parse_error::ParseError ProcessCommand(); |
| |
| // Processes all commands until get == put. |
| parse_error::ParseError ProcessAllCommands(); |
| |
| // Reports an error. |
| void ReportError(unsigned int command_id, parse_error::ParseError result); |
| |
| private: |
| CommandBufferOffset get_; |
| CommandBufferOffset put_; |
| CommandBufferEntry *buffer_; |
| size_t entry_count_; |
| AsyncAPIInterface *handler_; |
| }; |
| |
| // This class defines the interface for an asynchronous API handler, that |
| // is responsible for de-multiplexing commands and their arguments. |
| class AsyncAPIInterface { |
| public: |
| AsyncAPIInterface() {} |
| virtual ~AsyncAPIInterface() {} |
| |
| // Executes a command. |
| // Parameters: |
| // command: the command index. |
| // arg_count: the number of CommandBufferEntry arguments. |
| // cmd_data: the command data. |
| // Returns: |
| // parse_error::NO_ERROR if no error was found, one of |
| // parse_error::ParseError otherwise. |
| virtual parse_error::ParseError DoCommand( |
| unsigned int command, |
| unsigned int arg_count, |
| const void* cmd_data) = 0; |
| |
| // Returns a name for a command. Useful for logging / debuging. |
| virtual const char* GetCommandName(unsigned int command_id) const = 0; |
| }; |
| |
| } // namespace command_buffer |
| |
| #endif // GPU_COMMAND_BUFFER_SERVICE_CROSS_CMD_PARSER_H_ |