2 * Copyright 2013 Advanced Micro Devices, Inc.
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23 * Authors: Marek Olšák <maraeo@gmail.com>
28 * This file contains common screen and context structures and functions
29 * for r600g and radeonsi.
32 #ifndef R600_PIPE_COMMON_H
33 #define R600_PIPE_COMMON_H
37 #include "radeon/radeon_winsys.h"
39 #include "util/u_blitter.h"
40 #include "util/list.h"
41 #include "util/u_range.h"
42 #include "util/u_slab.h"
43 #include "util/u_suballoc.h"
44 #include "util/u_transfer.h"
46 #define R600_RESOURCE_FLAG_TRANSFER (PIPE_RESOURCE_FLAG_DRV_PRIV << 0)
47 #define R600_RESOURCE_FLAG_FLUSHED_DEPTH (PIPE_RESOURCE_FLAG_DRV_PRIV << 1)
48 #define R600_RESOURCE_FLAG_FORCE_TILING (PIPE_RESOURCE_FLAG_DRV_PRIV << 2)
50 #define R600_CONTEXT_STREAMOUT_FLUSH (1u << 0)
51 #define R600_CONTEXT_PRIVATE_FLAG (1u << 1)
53 /* special primitive types */
54 #define R600_PRIM_RECTANGLE_LIST PIPE_PRIM_MAX
58 #define DBG_TEX (1 << 0)
60 #define DBG_COMPUTE (1 << 2)
61 #define DBG_VM (1 << 3)
62 #define DBG_TRACE_CS (1 << 4)
64 #define DBG_FS (1 << 5)
65 #define DBG_VS (1 << 6)
66 #define DBG_GS (1 << 7)
67 #define DBG_PS (1 << 8)
68 #define DBG_CS (1 << 9)
69 #define DBG_TCS (1 << 10)
70 #define DBG_TES (1 << 11)
71 #define DBG_NO_IR (1 << 12)
72 #define DBG_NO_TGSI (1 << 13)
73 #define DBG_NO_ASM (1 << 14)
74 #define DBG_PREOPT_IR (1 << 15)
75 /* Bits 21-31 are reserved for the r600g driver. */
77 #define DBG_NO_ASYNC_DMA (1llu << 32)
78 #define DBG_NO_HYPERZ (1llu << 33)
79 #define DBG_NO_DISCARD_RANGE (1llu << 34)
80 #define DBG_NO_2D_TILING (1llu << 35)
81 #define DBG_NO_TILING (1llu << 36)
82 #define DBG_SWITCH_ON_EOP (1llu << 37)
83 #define DBG_FORCE_DMA (1llu << 38)
84 #define DBG_PRECOMPILE (1llu << 39)
85 #define DBG_INFO (1llu << 40)
86 #define DBG_NO_WC (1llu << 41)
87 #define DBG_CHECK_VM (1llu << 42)
88 #define DBG_NO_DCC (1llu << 43)
89 #define DBG_NO_DCC_CLEAR (1llu << 44)
90 #define DBG_NO_RB_PLUS (1llu << 45)
91 #define DBG_SI_SCHED (1llu << 46)
93 #define R600_MAP_BUFFER_ALIGNMENT 64
95 struct r600_common_context
;
96 struct r600_perfcounters
;
98 struct radeon_shader_reloc
{
103 struct radeon_shader_binary
{
108 /** Config/Context register state that accompanies this shader.
109 * This is a stream of dword pairs. First dword contains the
110 * register address, the second dword contains the value.*/
111 unsigned char *config
;
112 unsigned config_size
;
114 /** The number of bytes of config information for each global symbol.
116 unsigned config_size_per_symbol
;
118 /** Constant data accessed by the shader. This will be uploaded
119 * into a constant buffer. */
120 unsigned char *rodata
;
121 unsigned rodata_size
;
123 /** List of symbol offsets for the shader */
124 uint64_t *global_symbol_offsets
;
125 unsigned global_symbol_count
;
127 struct radeon_shader_reloc
*relocs
;
128 unsigned reloc_count
;
130 /** Disassembled shader in a string. */
134 void radeon_shader_binary_init(struct radeon_shader_binary
*b
);
135 void radeon_shader_binary_clean(struct radeon_shader_binary
*b
);
137 struct r600_resource
{
140 /* Winsys objects. */
141 struct pb_buffer
*buf
;
142 uint64_t gpu_address
;
144 /* Resource state. */
145 enum radeon_bo_domain domains
;
147 /* The buffer range which is initialized (with a write transfer,
148 * streamout, DMA, or as a random access target). The rest of
149 * the buffer is considered invalid and can be mapped unsynchronized.
151 * This allows unsychronized mapping of a buffer range which hasn't
152 * been used yet. It's for applications which forget to use
153 * the unsynchronized map flag and expect the driver to figure it out.
155 struct util_range valid_buffer_range
;
157 /* For buffers only. This indicates that a write operation has been
158 * performed by TC L2, but the cache hasn't been flushed.
159 * Any hw block which doesn't use or bypasses TC L2 should check this
160 * flag and flush the cache before using the buffer.
162 * For example, TC L2 must be flushed if a buffer which has been
163 * modified by a shader store instruction is about to be used as
164 * an index buffer. The reason is that VGT DMA index fetching doesn't
170 struct r600_transfer
{
171 struct pipe_transfer transfer
;
172 struct r600_resource
*staging
;
176 struct r600_fmask_info
{
180 unsigned pitch_in_pixels
;
181 unsigned bank_height
;
182 unsigned slice_tile_max
;
183 unsigned tile_mode_index
;
186 struct r600_cmask_info
{
194 unsigned slice_tile_max
;
195 unsigned base_address_reg
;
198 struct r600_htile_info
{
205 struct r600_texture
{
206 struct r600_resource resource
;
210 unsigned dirty_level_mask
; /* each bit says if that mipmap is compressed */
211 unsigned stencil_dirty_level_mask
; /* each bit says if that mipmap is compressed */
212 struct r600_texture
*flushed_depth_texture
;
213 boolean is_flushing_texture
;
214 struct radeon_surf surface
;
216 /* Colorbuffer compression and fast clear. */
217 struct r600_fmask_info fmask
;
218 struct r600_cmask_info cmask
;
219 struct r600_resource
*cmask_buffer
;
220 struct r600_resource
*dcc_buffer
;
221 unsigned cb_color_info
; /* fast clear enable bit */
222 unsigned color_clear_value
[2];
224 /* Depth buffer compression and fast clear. */
225 struct r600_htile_info htile
;
226 struct r600_resource
*htile_buffer
;
227 bool depth_cleared
; /* if it was cleared at least once */
228 float depth_clear_value
;
229 bool stencil_cleared
; /* if it was cleared at least once */
230 uint8_t stencil_clear_value
;
232 bool non_disp_tiling
; /* R600-Cayman only */
235 struct r600_surface
{
236 struct pipe_surface base
;
238 bool color_initialized
;
239 bool depth_initialized
;
241 /* Misc. color flags. */
242 bool alphatest_bypass
;
246 /* Color registers. */
247 unsigned cb_color_info
;
248 unsigned cb_color_base
;
249 unsigned cb_color_view
;
250 unsigned cb_color_size
; /* R600 only */
251 unsigned cb_color_dim
; /* EG only */
252 unsigned cb_color_pitch
; /* EG and later */
253 unsigned cb_color_slice
; /* EG and later */
254 unsigned cb_dcc_base
; /* VI and later */
255 unsigned cb_color_attrib
; /* EG and later */
256 unsigned cb_dcc_control
; /* VI and later */
257 unsigned cb_color_fmask
; /* CB_COLORn_FMASK (EG and later) or CB_COLORn_FRAG (r600) */
258 unsigned cb_color_fmask_slice
; /* EG and later */
259 unsigned cb_color_cmask
; /* CB_COLORn_TILE (r600 only) */
260 unsigned cb_color_mask
; /* R600 only */
261 unsigned spi_shader_col_format
; /* SI+, no blending, no alpha-to-coverage. */
262 unsigned spi_shader_col_format_alpha
; /* SI+, alpha-to-coverage */
263 unsigned spi_shader_col_format_blend
; /* SI+, blending without alpha. */
264 unsigned spi_shader_col_format_blend_alpha
; /* SI+, blending with alpha. */
265 struct r600_resource
*cb_buffer_fmask
; /* Used for FMASK relocations. R600 only */
266 struct r600_resource
*cb_buffer_cmask
; /* Used for CMASK relocations. R600 only */
269 unsigned db_depth_info
; /* R600 only, then SI and later */
270 unsigned db_z_info
; /* EG and later */
271 unsigned db_depth_base
; /* DB_Z_READ/WRITE_BASE (EG and later) or DB_DEPTH_BASE (r600) */
272 unsigned db_depth_view
;
273 unsigned db_depth_size
;
274 unsigned db_depth_slice
; /* EG and later */
275 unsigned db_stencil_base
; /* EG and later */
276 unsigned db_stencil_info
; /* EG and later */
277 unsigned db_prefetch_limit
; /* R600 only */
278 unsigned db_htile_surface
;
279 unsigned db_htile_data_base
;
280 unsigned db_preload_control
; /* EG and later */
281 unsigned pa_su_poly_offset_db_fmt_cntl
;
284 struct r600_common_screen
{
285 struct pipe_screen b
;
286 struct radeon_winsys
*ws
;
287 enum radeon_family family
;
288 enum chip_class chip_class
;
289 struct radeon_info info
;
290 uint64_t debug_flags
;
294 /* Auxiliary context. Mainly used to initialize resources.
295 * It must be locked prior to using and flushed before unlocking. */
296 struct pipe_context
*aux_context
;
297 pipe_mutex aux_context_lock
;
299 struct r600_resource
*trace_bo
;
303 /* This must be in the screen, because UE4 uses one context for
304 * compilation and another one for rendering.
306 unsigned num_compilations
;
307 /* Along with ST_DEBUG=precompile, this should show if applications
308 * are loading shaders on demand. This is a monotonic counter.
310 unsigned num_shaders_created
;
312 /* GPU load thread. */
313 pipe_mutex gpu_load_mutex
;
314 pipe_thread gpu_load_thread
;
315 unsigned gpu_load_counter_busy
;
316 unsigned gpu_load_counter_idle
;
317 volatile unsigned gpu_load_stop_thread
; /* bool */
319 char renderer_string
[64];
321 /* Performance counters. */
322 struct r600_perfcounters
*perfcounters
;
325 /* This encapsulates a state or an operation which can emitted into the GPU
328 void (*emit
)(struct r600_common_context
*ctx
, struct r600_atom
*state
);
333 struct r600_so_target
{
334 struct pipe_stream_output_target b
;
336 /* The buffer where BUFFER_FILLED_SIZE is stored. */
337 struct r600_resource
*buf_filled_size
;
338 unsigned buf_filled_size_offset
;
339 bool buf_filled_size_valid
;
341 unsigned stride_in_dw
;
344 struct r600_streamout
{
345 struct r600_atom begin_atom
;
347 unsigned num_dw_for_end
;
349 unsigned enabled_mask
;
350 unsigned num_targets
;
351 struct r600_so_target
*targets
[PIPE_MAX_SO_BUFFERS
];
353 unsigned append_bitmask
;
356 /* External state which comes from the vertex shader,
357 * it must be set explicitly when binding a shader. */
358 unsigned *stride_in_dw
;
359 unsigned enabled_stream_buffers_mask
; /* stream0 buffers0-3 in 4 LSB */
361 /* The state of VGT_STRMOUT_BUFFER_(CONFIG|EN). */
362 unsigned hw_enabled_mask
;
364 /* The state of VGT_STRMOUT_(CONFIG|EN). */
365 struct r600_atom enable_atom
;
366 bool streamout_enabled
;
367 bool prims_gen_query_enabled
;
368 int num_prims_gen_queries
;
372 struct radeon_winsys_cs
*cs
;
373 void (*flush
)(void *ctx
, unsigned flags
,
374 struct pipe_fence_handle
**fence
);
377 struct r600_common_context
{
378 struct pipe_context b
; /* base class */
380 struct r600_common_screen
*screen
;
381 struct radeon_winsys
*ws
;
382 struct radeon_winsys_ctx
*ctx
;
383 enum radeon_family family
;
384 enum chip_class chip_class
;
385 struct r600_ring gfx
;
386 struct r600_ring dma
;
387 struct pipe_fence_handle
*last_sdma_fence
;
388 unsigned initial_gfx_cs_size
;
389 unsigned gpu_reset_counter
;
391 struct u_upload_mgr
*uploader
;
392 struct u_suballocator
*allocator_so_filled_size
;
393 struct util_slab_mempool pool_transfers
;
395 /* Current unaccounted memory usage. */
400 struct r600_streamout streamout
;
402 /* Additional context states. */
403 unsigned flags
; /* flush flags */
406 /* The list of active queries. Only one query of each type can be active. */
407 int num_occlusion_queries
;
408 /* Keep track of non-timer queries, because they should be suspended
409 * during context flushing.
410 * The timer queries (TIME_ELAPSED) shouldn't be suspended for blits,
411 * but they should be suspended between IBs. */
412 struct list_head active_nontimer_queries
;
413 struct list_head active_timer_queries
;
414 unsigned num_cs_dw_nontimer_queries_suspend
;
415 bool nontimer_queries_suspended_by_flush
;
416 unsigned num_cs_dw_timer_queries_suspend
;
417 /* Additional hardware info. */
418 unsigned backend_mask
;
419 unsigned max_db
; /* for OQ */
421 unsigned num_draw_calls
;
423 /* Render condition. */
424 struct r600_atom render_cond_atom
;
425 struct pipe_query
*render_cond
;
426 unsigned render_cond_mode
;
427 boolean render_cond_invert
;
428 bool render_cond_force_off
; /* for u_blitter */
430 /* MSAA sample locations.
431 * The first index is the sample index.
432 * The second index is the coordinate: X, Y. */
433 float sample_locations_1x
[1][2];
434 float sample_locations_2x
[2][2];
435 float sample_locations_4x
[4][2];
436 float sample_locations_8x
[8][2];
437 float sample_locations_16x
[16][2];
439 /* The list of all texture buffer objects in this context.
440 * This list is walked when a buffer is invalidated/reallocated and
441 * the GPU addresses are updated. */
442 struct list_head texture_buffers
;
444 struct pipe_debug_callback debug
;
446 /* Copy one resource to another using async DMA. */
447 void (*dma_copy
)(struct pipe_context
*ctx
,
448 struct pipe_resource
*dst
,
450 unsigned dst_x
, unsigned dst_y
, unsigned dst_z
,
451 struct pipe_resource
*src
,
453 const struct pipe_box
*src_box
);
455 void (*clear_buffer
)(struct pipe_context
*ctx
, struct pipe_resource
*dst
,
456 unsigned offset
, unsigned size
, unsigned value
,
457 bool is_framebuffer
);
459 void (*blit_decompress_depth
)(struct pipe_context
*ctx
,
460 struct r600_texture
*texture
,
461 struct r600_texture
*staging
,
462 unsigned first_level
, unsigned last_level
,
463 unsigned first_layer
, unsigned last_layer
,
464 unsigned first_sample
, unsigned last_sample
);
466 /* Reallocate the buffer and update all resource bindings where
467 * the buffer is bound, including all resource descriptors. */
468 void (*invalidate_buffer
)(struct pipe_context
*ctx
, struct pipe_resource
*buf
);
470 /* Enable or disable occlusion queries. */
471 void (*set_occlusion_query_state
)(struct pipe_context
*ctx
, bool enable
);
473 /* This ensures there is enough space in the command stream. */
474 void (*need_gfx_cs_space
)(struct pipe_context
*ctx
, unsigned num_dw
,
475 bool include_draw_vbo
);
477 void (*set_atom_dirty
)(struct r600_common_context
*ctx
,
478 struct r600_atom
*atom
, bool dirty
);
482 boolean
r600_rings_is_buffer_referenced(struct r600_common_context
*ctx
,
483 struct pb_buffer
*buf
,
484 enum radeon_bo_usage usage
);
485 void *r600_buffer_map_sync_with_rings(struct r600_common_context
*ctx
,
486 struct r600_resource
*resource
,
488 bool r600_init_resource(struct r600_common_screen
*rscreen
,
489 struct r600_resource
*res
,
490 unsigned size
, unsigned alignment
,
491 bool use_reusable_pool
);
492 struct pipe_resource
*r600_buffer_create(struct pipe_screen
*screen
,
493 const struct pipe_resource
*templ
,
495 struct pipe_resource
* r600_aligned_buffer_create(struct pipe_screen
*screen
,
500 struct pipe_resource
*
501 r600_buffer_from_user_memory(struct pipe_screen
*screen
,
502 const struct pipe_resource
*templ
,
505 r600_invalidate_resource(struct pipe_context
*ctx
,
506 struct pipe_resource
*resource
);
508 /* r600_common_pipe.c */
509 void r600_draw_rectangle(struct blitter_context
*blitter
,
510 int x1
, int y1
, int x2
, int y2
, float depth
,
511 enum blitter_attrib_type type
,
512 const union pipe_color_union
*attrib
);
513 bool r600_common_screen_init(struct r600_common_screen
*rscreen
,
514 struct radeon_winsys
*ws
);
515 void r600_destroy_common_screen(struct r600_common_screen
*rscreen
);
516 void r600_preflush_suspend_features(struct r600_common_context
*ctx
);
517 void r600_postflush_resume_features(struct r600_common_context
*ctx
);
518 bool r600_common_context_init(struct r600_common_context
*rctx
,
519 struct r600_common_screen
*rscreen
);
520 void r600_common_context_cleanup(struct r600_common_context
*rctx
);
521 void r600_context_add_resource_size(struct pipe_context
*ctx
, struct pipe_resource
*r
);
522 bool r600_can_dump_shader(struct r600_common_screen
*rscreen
,
524 void r600_screen_clear_buffer(struct r600_common_screen
*rscreen
, struct pipe_resource
*dst
,
525 unsigned offset
, unsigned size
, unsigned value
,
526 bool is_framebuffer
);
527 struct pipe_resource
*r600_resource_create_common(struct pipe_screen
*screen
,
528 const struct pipe_resource
*templ
);
529 const char *r600_get_llvm_processor_name(enum radeon_family family
);
530 void r600_need_dma_space(struct r600_common_context
*ctx
, unsigned num_dw
);
532 /* r600_gpu_load.c */
533 void r600_gpu_load_kill_thread(struct r600_common_screen
*rscreen
);
534 uint64_t r600_gpu_load_begin(struct r600_common_screen
*rscreen
);
535 unsigned r600_gpu_load_end(struct r600_common_screen
*rscreen
, uint64_t begin
);
537 /* r600_perfcounters.c */
538 void r600_perfcounters_destroy(struct r600_common_screen
*rscreen
);
541 void r600_init_screen_query_functions(struct r600_common_screen
*rscreen
);
542 void r600_query_init(struct r600_common_context
*rctx
);
543 void r600_suspend_nontimer_queries(struct r600_common_context
*ctx
);
544 void r600_resume_nontimer_queries(struct r600_common_context
*ctx
);
545 void r600_suspend_timer_queries(struct r600_common_context
*ctx
);
546 void r600_resume_timer_queries(struct r600_common_context
*ctx
);
547 void r600_query_init_backend_mask(struct r600_common_context
*ctx
);
549 /* r600_streamout.c */
550 void r600_streamout_buffers_dirty(struct r600_common_context
*rctx
);
551 void r600_set_streamout_targets(struct pipe_context
*ctx
,
552 unsigned num_targets
,
553 struct pipe_stream_output_target
**targets
,
554 const unsigned *offset
);
555 void r600_emit_streamout_end(struct r600_common_context
*rctx
);
556 void r600_update_prims_generated_query_state(struct r600_common_context
*rctx
,
557 unsigned type
, int diff
);
558 void r600_streamout_init(struct r600_common_context
*rctx
);
561 void r600_texture_get_fmask_info(struct r600_common_screen
*rscreen
,
562 struct r600_texture
*rtex
,
564 struct r600_fmask_info
*out
);
565 void r600_texture_get_cmask_info(struct r600_common_screen
*rscreen
,
566 struct r600_texture
*rtex
,
567 struct r600_cmask_info
*out
);
568 bool r600_init_flushed_depth_texture(struct pipe_context
*ctx
,
569 struct pipe_resource
*texture
,
570 struct r600_texture
**staging
);
571 void r600_print_texture_info(struct r600_texture
*rtex
, FILE *f
);
572 struct pipe_resource
*r600_texture_create(struct pipe_screen
*screen
,
573 const struct pipe_resource
*templ
);
574 struct pipe_surface
*r600_create_surface_custom(struct pipe_context
*pipe
,
575 struct pipe_resource
*texture
,
576 const struct pipe_surface
*templ
,
577 unsigned width
, unsigned height
);
578 unsigned r600_translate_colorswap(enum pipe_format format
);
579 void evergreen_do_fast_color_clear(struct r600_common_context
*rctx
,
580 struct pipe_framebuffer_state
*fb
,
581 struct r600_atom
*fb_state
,
582 unsigned *buffers
, unsigned *dirty_cbufs
,
583 const union pipe_color_union
*color
);
584 void r600_init_screen_texture_functions(struct r600_common_screen
*rscreen
);
585 void r600_init_context_texture_functions(struct r600_common_context
*rctx
);
588 extern const uint32_t eg_sample_locs_2x
[4];
589 extern const unsigned eg_max_dist_2x
;
590 extern const uint32_t eg_sample_locs_4x
[4];
591 extern const unsigned eg_max_dist_4x
;
592 void cayman_get_sample_position(struct pipe_context
*ctx
, unsigned sample_count
,
593 unsigned sample_index
, float *out_value
);
594 void cayman_init_msaa(struct pipe_context
*ctx
);
595 void cayman_emit_msaa_sample_locs(struct radeon_winsys_cs
*cs
, int nr_samples
);
596 void cayman_emit_msaa_config(struct radeon_winsys_cs
*cs
, int nr_samples
,
597 int ps_iter_samples
, int overrast_samples
);
600 /* Inline helpers. */
602 static inline struct r600_resource
*r600_resource(struct pipe_resource
*r
)
604 return (struct r600_resource
*)r
;
608 r600_resource_reference(struct r600_resource
**ptr
, struct r600_resource
*res
)
610 pipe_resource_reference((struct pipe_resource
**)ptr
,
611 (struct pipe_resource
*)res
);
614 static inline unsigned r600_tex_aniso_filter(unsigned filter
)
616 if (filter
<= 1) return 0;
617 if (filter
<= 2) return 1;
618 if (filter
<= 4) return 2;
619 if (filter
<= 8) return 3;
623 static inline unsigned r600_wavefront_size(enum radeon_family family
)
643 static inline enum radeon_bo_priority
644 r600_get_sampler_view_priority(struct r600_resource
*res
)
646 if (res
->b
.b
.target
== PIPE_BUFFER
)
647 return RADEON_PRIO_SAMPLER_BUFFER
;
649 if (res
->b
.b
.nr_samples
> 1)
650 return RADEON_PRIO_SAMPLER_TEXTURE_MSAA
;
652 return RADEON_PRIO_SAMPLER_TEXTURE
;
655 #define COMPUTE_DBG(rscreen, fmt, args...) \
657 if ((rscreen->b.debug_flags & DBG_COMPUTE)) fprintf(stderr, fmt, ##args); \
660 #define R600_ERR(fmt, args...) \
661 fprintf(stderr, "EE %s:%d %s - "fmt, __FILE__, __LINE__, __func__, ##args)
663 /* For MSAA sample positions. */
664 #define FILL_SREG(s0x, s0y, s1x, s1y, s2x, s2y, s3x, s3y) \
665 (((s0x) & 0xf) | (((s0y) & 0xf) << 4) | \
666 (((s1x) & 0xf) << 8) | (((s1y) & 0xf) << 12) | \
667 (((s2x) & 0xf) << 16) | (((s2y) & 0xf) << 20) | \
668 (((s3x) & 0xf) << 24) | (((s3y) & 0xf) << 28))