A binary buffer is a region of physical memory used to temporarily hold data while it is being moved from one place to another or manipulated in some way, for example you can use a buffer to hold packet data awaiting transmission over a network or for storing a packet that has been received over a network. GameMaker Studio 2 has a number of specific functions related to creating, modifying and loading/saving buffers, but before using them please note the following points:

• 一个缓冲区创建后，会自动清除并填充为0。
• 
  
• 缓冲区函数的“size”参数始终指的是以字节为单位的缓冲区的大小。
• 
  
• The "Alignment" argument refers to how data is stored within a buffer. If your alignment is set to say, 4, and you write a single piece of data which is 1 byte in size then do a buffer_tell, you'll get an offset of 1. However, if you write another piece of data, also 1 byte in size, then do a buffer_tell, you'll get an offset of 5 as the alignment has "padded" the data to that size. Alignment only affects where things are written to, so if you do a buffer_tell after you write something, it'll return the current write position which immediately follows the data you've written. 但是，请注意，如果你随后编写另一个数据片段，那么在实际编写该数据片段之前，缓冲区会在内部将写入位置移动到对齐大小的下一个倍数。
• 
  
• When dealing with "offset", this is the value in bytes to offset the data by within the given buffer. So if your buffer is 2 byte aligned and you want to skip the first 4 aligned places, you would have an offset of 2 * 4 bytes.
• 
  
• Some of the buffer functions also create a new buffer (like buffer_load for example). Remember that these buffers will also need to be removed from memory when not in use using the buffer_delete function.
• 
  
• The memory used for creating buffers is system memory so even when the game doesn't have focus, any data stored in a buffer should be safe, however if the app is closed or re-started then it will be lost.

The following pages explain how buffers work within the context of GameMaker Studio 2 and contain a couple of code examples for those users that are unsure of how to use them:

1. 使用缓冲区
   

The following functions exist for you to use with binary buffers in your games:

• buffer_exists
  
• buffer_create
  
• buffer_create_from_vertex_buffer
  
• buffer_create_from_vertex_buffer_ext
  
• buffer_delete
  
• buffer_read
  
• buffer_write
  
• buffer_fill
  
• buffer_seek
  
• buffer_tell
  
• buffer_peek
  
• buffer_poke
  
• buffer_save
  
• buffer_save_ext
  
• buffer_save_async
  
• buffer_load
  
• buffer_load_ext
  
• buffer_load_async
  
• buffer_compress
  
• buffer_decompress
  
• buffer_async_group_begin
  
• buffer_async_group_option
  
• buffer_async_group_end
  
• buffer_copy
  
• buffer_copy_from_vertex_buffer
  
• buffer_get_type
  
• buffer_get_alignment
  
• buffer_get_address
  
• buffer_get_size
  
• buffer_get_surface
  
• buffer_set_surface
  
• buffer_resize
  
• buffer_sizeof
  
• buffer_md5
  
• buffer_sha1
  
• buffer_base64_encode
  
• buffer_base64_decode
  
• buffer_base64_decode_ext
  

There are also two extra functions related to buffers that can be used to save and load game states (note that they require a buffer to have been created previously):

• game_load_buffer
  
• game_save_buffer
  

Finally, you can also use special Vertex Buffers to create your own custom primitives or models, etc... You can find out more about these from the following section of the manual:

1. 杂项游戏功能