blob: c2cab6df73289dea61be7932536342672b819a90 [file] [log] [blame]
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +01001// Copyright (c) 2015 The Khronos Group Inc.
2//
3// Permission is hereby granted, free of charge, to any person obtaining a
4// copy of this software and/or associated documentation files (the
5// "Materials"), to deal in the Materials without restriction, including
6// without limitation the rights to use, copy, modify, merge, publish,
7// distribute, sublicense, and/or sell copies of the Materials, and to
8// permit persons to whom the Materials are furnished to do so, subject to
9// the following conditions:
10//
11// The above copyright notice and this permission notice shall be included
12// in all copies or substantial portions of the Materials.
13//
14// MODIFICATIONS TO THIS FILE MAY MEAN IT NO LONGER ACCURATELY REFLECTS
15// KHRONOS STANDARDS. THE UNMODIFIED, NORMATIVE VERSIONS OF KHRONOS
16// SPECIFICATIONS AND HEADER INFORMATION ARE LOCATED AT
17// https://www.khronos.org/registry/
18//
19// THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
20// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
21// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
22// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
23// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
24// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
25// MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
26
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010027#include "opcode.h"
28
29#include <assert.h>
30#include <string.h>
31
Lei Zhang972788b2015-11-12 13:48:30 -050032#include <cstdlib>
33
Lei Zhang923f6c12015-11-11 12:45:23 -050034#include "endian.h"
35#include "instruction.h"
36#include "libspirv/libspirv.h"
Lei Zhangaa056cd2015-11-11 14:24:04 -050037#include "spirv_constant.h"
Lei Zhang4ac601a2015-11-11 17:29:23 -050038#include "spirv_operands.h"
Lei Zhang923f6c12015-11-11 12:45:23 -050039
David Neto78c3b432015-08-27 13:03:52 -040040namespace {
41
42// Descriptions of each opcode. Each entry describes the format of the
43// instruction that follows a particular opcode.
44//
45// Most fields are initialized statically by including an automatically
46// generated file.
47// The operandTypes fields are initialized during spvOpcodeInitialize().
48//
49// TODO(dneto): Some of the macros are quite unreadable. We could make
50// good use of constexpr functions, but some compilers don't support that yet.
Lei Zhang972788b2015-11-12 13:48:30 -050051const spv_opcode_desc_t opcodeTableEntries[] = {
Lei Zhang1a0334e2015-11-02 09:41:20 -050052#define EmptyList \
53 {}
54#define List(...) \
55 { __VA_ARGS__ }
Lei Zhangb36e7042015-10-28 13:40:52 -040056#define Capability(X) SPV_CAPABILITY_AS_MASK(SpvCapability##X)
Lei Zhang1a0334e2015-11-02 09:41:20 -050057#define Capability2(X, Y) Capability(X) | Capability(Y)
58#define SpvCapabilityNone \
59 0 // Needed so Capability(None) still expands to valid syntax.
David Neto201caf72015-11-04 17:38:17 -050060#define Instruction(Name, HasResult, HasType, NumLogicalOperands, \
61 NumCapabilities, CapabilityRequired, IsVariable, \
62 LogicalArgsList) \
63 {#Name, SpvOp##Name, (NumCapabilities) ? (CapabilityRequired) : 0, \
64 0, {}, /* Filled in later. Operand list, including \
65 result id and type id, if needed */ \
66 HasResult, HasType, LogicalArgsList},
David Neto78c3b432015-08-27 13:03:52 -040067#include "opcode.inc"
68#undef EmptyList
69#undef List
70#undef Capability
Dejan Mircevski205408b2015-09-30 16:42:34 -040071#undef Capability2
David Neto78c3b432015-08-27 13:03:52 -040072#undef CapabilityNone
73#undef Instruction
74};
75
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010076// Opcode API
77
David Neto78c3b432015-08-27 13:03:52 -040078// Converts the given operand class enum (from the SPIR-V document generation
David Neto0f166be2015-11-11 01:56:49 -050079// logic) to the operand type required by the parser. The SPV_OPERAND_TYPE_NONE
80// value indicates there is no current operand and no further operands.
David Neto78c3b432015-08-27 13:03:52 -040081// This only applies to logical operands.
Lei Zhangb36e7042015-10-28 13:40:52 -040082spv_operand_type_t convertOperandClassToType(SpvOp opcode,
83 OperandClass operandClass) {
David Neto78c3b432015-08-27 13:03:52 -040084 // The spec document generator uses OptionalOperandLiteral for several kinds
85 // of repeating values. Our parser needs more specific information about
86 // what is being repeated.
87 if (operandClass == OperandOptionalLiteral) {
Lei Zhang40056702015-09-11 14:31:27 -040088 switch (opcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -040089 case SpvOpLoad:
90 case SpvOpStore:
91 case SpvOpCopyMemory:
92 case SpvOpCopyMemorySized:
David Neto3fca4cd2015-09-17 17:39:45 -040093 // Expect an optional mask. When the Aligned bit is set in the mask,
94 // we will later add the expectation of a literal number operand.
95 return SPV_OPERAND_TYPE_OPTIONAL_MEMORY_ACCESS;
Lei Zhangb36e7042015-10-28 13:40:52 -040096 case SpvOpExecutionMode:
David Neto78c3b432015-08-27 13:03:52 -040097 return SPV_OPERAND_TYPE_VARIABLE_EXECUTION_MODE;
98 default:
99 break;
100 }
Lei Zhangb41d1502015-09-14 15:22:23 -0400101 } else if (operandClass == OperandVariableLiterals) {
David Neto201caf72015-11-04 17:38:17 -0500102 if (opcode == SpvOpConstant || opcode == SpvOpSpecConstant) {
103 // The number type is determined by the type Id operand.
104 return SPV_OPERAND_TYPE_TYPED_LITERAL_NUMBER;
105 }
David Neto78c3b432015-08-27 13:03:52 -0400106 }
107
Lei Zhang1a0334e2015-11-02 09:41:20 -0500108 switch (operandClass) {
109 case OperandNone:
110 return SPV_OPERAND_TYPE_NONE;
111 case OperandId:
112 return SPV_OPERAND_TYPE_ID;
113 case OperandOptionalId:
114 return SPV_OPERAND_TYPE_OPTIONAL_ID;
115 case OperandOptionalImage:
116 return SPV_OPERAND_TYPE_OPTIONAL_IMAGE;
117 case OperandVariableIds:
David Neto0f166be2015-11-11 01:56:49 -0500118 if (opcode == SpvOpSpecConstantOp) {
119 // These are the operands to the specialization constant opcode.
120 // The assembler and binary parser set up the extra Id and literal
121 // arguments when processing the opcode operand. So don't add
122 // an operand type for them here.
123 return SPV_OPERAND_TYPE_NONE;
124 }
Lei Zhang1a0334e2015-11-02 09:41:20 -0500125 return SPV_OPERAND_TYPE_VARIABLE_ID;
David Neto561dc4e2015-09-25 14:23:29 -0400126 // The spec only uses OptionalLiteral for an optional literal number.
Lei Zhang1a0334e2015-11-02 09:41:20 -0500127 case OperandOptionalLiteral:
128 return SPV_OPERAND_TYPE_OPTIONAL_LITERAL_INTEGER;
129 case OperandOptionalLiteralString:
130 return SPV_OPERAND_TYPE_OPTIONAL_LITERAL_STRING;
David Neto561dc4e2015-09-25 14:23:29 -0400131 // This is only used for sequences of literal numbers.
Lei Zhang1a0334e2015-11-02 09:41:20 -0500132 case OperandVariableLiterals:
133 return SPV_OPERAND_TYPE_VARIABLE_LITERAL_INTEGER;
David Neto445ce442015-10-15 15:22:06 -0400134 case OperandLiteralNumber:
Lei Zhangb36e7042015-10-28 13:40:52 -0400135 if (opcode == SpvOpExtInst) {
David Neto445ce442015-10-15 15:22:06 -0400136 // We use a special operand type for the extension instruction number.
Lei Zhang1a0334e2015-11-02 09:41:20 -0500137 // For now, we assume there is only one LiteraNumber argument to
138 // OpExtInst, and it is the extension instruction argument.
David Neto445ce442015-10-15 15:22:06 -0400139 // See the ExtInst entry in opcode.inc
140 // TODO(dneto): Use a function to confirm the assumption, and to verify
141 // that the index into the operandClass is 1, as expected.
142 return SPV_OPERAND_TYPE_EXTENSION_INSTRUCTION_NUMBER;
David Neto0f166be2015-11-11 01:56:49 -0500143 } else if (opcode == SpvOpSpecConstantOp) {
144 // Use a special operand type for the opcode operand, so we can
145 // use mnemonic names instead of the numbers. For example, the
146 // assembler should accept "IAdd" instead of the numeric value of
147 // SpvOpIAdd.
148 return SPV_OPERAND_TYPE_SPEC_CONSTANT_OP_NUMBER;
David Neto445ce442015-10-15 15:22:06 -0400149 }
150 return SPV_OPERAND_TYPE_LITERAL_INTEGER;
Lei Zhang1a0334e2015-11-02 09:41:20 -0500151 case OperandLiteralString:
152 return SPV_OPERAND_TYPE_LITERAL_STRING;
153 case OperandSource:
154 return SPV_OPERAND_TYPE_SOURCE_LANGUAGE;
155 case OperandExecutionModel:
156 return SPV_OPERAND_TYPE_EXECUTION_MODEL;
157 case OperandAddressing:
158 return SPV_OPERAND_TYPE_ADDRESSING_MODEL;
159 case OperandMemory:
160 return SPV_OPERAND_TYPE_MEMORY_MODEL;
161 case OperandExecutionMode:
162 return SPV_OPERAND_TYPE_EXECUTION_MODE;
163 case OperandStorage:
164 return SPV_OPERAND_TYPE_STORAGE_CLASS;
165 case OperandDimensionality:
166 return SPV_OPERAND_TYPE_DIMENSIONALITY;
167 case OperandSamplerAddressingMode:
168 return SPV_OPERAND_TYPE_SAMPLER_ADDRESSING_MODE;
169 case OperandSamplerFilterMode:
170 return SPV_OPERAND_TYPE_SAMPLER_FILTER_MODE;
171 case OperandSamplerImageFormat:
172 return SPV_OPERAND_TYPE_SAMPLER_IMAGE_FORMAT;
David Neto7cefb232015-09-28 15:33:49 -0400173 case OperandImageChannelOrder:
174 // This is only used to describe the value generated by OpImageQueryOrder.
175 // It is not used as an operand.
176 break;
177 case OperandImageChannelDataType:
Lei Zhang1a0334e2015-11-02 09:41:20 -0500178 // This is only used to describe the value generated by
179 // OpImageQueryFormat. It is not used as an operand.
David Neto7cefb232015-09-28 15:33:49 -0400180 break;
181 case OperandImageOperands:
Dejan Mircevskif8e091a2015-10-13 14:41:31 -0400182 // This is not used in opcode.inc. It only exists to generate the
183 // corresponding spec section. In parsing, image operands meld into the
184 // OperandOptionalImage case.
David Neto7cefb232015-09-28 15:33:49 -0400185 break;
Lei Zhang1a0334e2015-11-02 09:41:20 -0500186 case OperandFPFastMath:
187 return SPV_OPERAND_TYPE_FP_FAST_MATH_MODE;
188 case OperandFPRoundingMode:
189 return SPV_OPERAND_TYPE_FP_ROUNDING_MODE;
190 case OperandLinkageType:
191 return SPV_OPERAND_TYPE_LINKAGE_TYPE;
192 case OperandAccessQualifier:
193 return SPV_OPERAND_TYPE_ACCESS_QUALIFIER;
194 case OperandFuncParamAttr:
195 return SPV_OPERAND_TYPE_FUNCTION_PARAMETER_ATTRIBUTE;
196 case OperandDecoration:
197 return SPV_OPERAND_TYPE_DECORATION;
198 case OperandBuiltIn:
199 return SPV_OPERAND_TYPE_BUILT_IN;
200 case OperandSelect:
201 return SPV_OPERAND_TYPE_SELECTION_CONTROL;
202 case OperandLoop:
203 return SPV_OPERAND_TYPE_LOOP_CONTROL;
204 case OperandFunction:
205 return SPV_OPERAND_TYPE_FUNCTION_CONTROL;
206 case OperandMemorySemantics:
207 return SPV_OPERAND_TYPE_MEMORY_SEMANTICS;
David Neto78c3b432015-08-27 13:03:52 -0400208 case OperandMemoryAccess:
David Neto7cefb232015-09-28 15:33:49 -0400209 // This case does not occur in the table for SPIR-V 0.99 Rev 32.
David Neto3fca4cd2015-09-17 17:39:45 -0400210 // We expect that it will become SPV_OPERAND_TYPE_OPTIONAL_MEMORY_ACCESS,
David Neto78c3b432015-08-27 13:03:52 -0400211 // and we can remove the special casing above for memory operation
212 // instructions.
213 break;
Lei Zhang1a0334e2015-11-02 09:41:20 -0500214 case OperandScope:
215 return SPV_OPERAND_TYPE_EXECUTION_SCOPE;
216 case OperandGroupOperation:
217 return SPV_OPERAND_TYPE_GROUP_OPERATION;
218 case OperandKernelEnqueueFlags:
219 return SPV_OPERAND_TYPE_KERNEL_ENQ_FLAGS;
220 case OperandKernelProfilingInfo:
221 return SPV_OPERAND_TYPE_KERNEL_PROFILING_INFO;
222 case OperandCapability:
223 return SPV_OPERAND_TYPE_CAPABILITY;
David Neto78c3b432015-08-27 13:03:52 -0400224
225 // Used by GroupMemberDecorate
Lei Zhang1a0334e2015-11-02 09:41:20 -0500226 case OperandVariableIdLiteral:
227 return SPV_OPERAND_TYPE_VARIABLE_ID_LITERAL_INTEGER;
David Neto78c3b432015-08-27 13:03:52 -0400228
229 // Used by Switch
Lei Zhang1a0334e2015-11-02 09:41:20 -0500230 case OperandVariableLiteralId:
231 return SPV_OPERAND_TYPE_VARIABLE_LITERAL_INTEGER_ID;
David Neto78c3b432015-08-27 13:03:52 -0400232
233 // These exceptional cases shouldn't occur.
234 case OperandCount:
235 default:
236 break;
237 }
238 assert(0 && "Unexpected operand class");
239 return SPV_OPERAND_TYPE_NONE;
240}
241
Lei Zhanga94701d2015-09-14 10:05:37 -0400242} // anonymous namespace
David Neto78c3b432015-08-27 13:03:52 -0400243
244// Finish populating the opcodeTableEntries array.
Lei Zhang972788b2015-11-12 13:48:30 -0500245void spvOpcodeTableInitialize(spv_opcode_desc_t* entries,
246 uint32_t num_entries) {
David Neto78c3b432015-08-27 13:03:52 -0400247 // Compute the operandTypes field for each entry.
Lei Zhang972788b2015-11-12 13:48:30 -0500248 for (uint32_t i = 0; i < num_entries; ++i) {
249 spv_opcode_desc_t& opcode = entries[i];
David Neto78c3b432015-08-27 13:03:52 -0400250 opcode.numTypes = 0;
251 // Type ID always comes first, if present.
252 if (opcode.hasType)
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400253 opcode.operandTypes[opcode.numTypes++] = SPV_OPERAND_TYPE_TYPE_ID;
David Neto78c3b432015-08-27 13:03:52 -0400254 // Result ID always comes next, if present
255 if (opcode.hasResult)
256 opcode.operandTypes[opcode.numTypes++] = SPV_OPERAND_TYPE_RESULT_ID;
Lei Zhanga94701d2015-09-14 10:05:37 -0400257 const uint16_t maxNumOperands =
258 sizeof(opcode.operandTypes) / sizeof(opcode.operandTypes[0]);
259 const uint16_t maxNumClasses =
260 sizeof(opcode.operandClass) / sizeof(opcode.operandClass[0]);
261 for (uint16_t classIndex = 0;
262 opcode.numTypes < maxNumOperands && classIndex < maxNumClasses;
263 classIndex++) {
David Neto78c3b432015-08-27 13:03:52 -0400264 const OperandClass operandClass = opcode.operandClass[classIndex];
David Neto0f166be2015-11-11 01:56:49 -0500265 const auto operandType =
Lei Zhanga94701d2015-09-14 10:05:37 -0400266 convertOperandClassToType(opcode.opcode, operandClass);
David Neto0f166be2015-11-11 01:56:49 -0500267 opcode.operandTypes[opcode.numTypes++] = operandType;
David Neto78c3b432015-08-27 13:03:52 -0400268 // The OperandNone value is not explicitly represented in the .inc file.
269 // However, it is the zero value, and is created via implicit value
David Neto0f166be2015-11-11 01:56:49 -0500270 // initialization. It converts to SPV_OPERAND_TYPE_NONE.
271 // The SPV_OPERAND_TYPE_NONE operand type indicates no current or futher
272 // operands.
273 if (operandType == SPV_OPERAND_TYPE_NONE) {
David Neto78c3b432015-08-27 13:03:52 -0400274 opcode.numTypes--;
275 break;
276 }
277 }
David Neto0f166be2015-11-11 01:56:49 -0500278
David Neto78c3b432015-08-27 13:03:52 -0400279 // We should have written the terminating SPV_OPERAND_TYPE_NONE entry, but
280 // also without overflowing.
Lei Zhanga94701d2015-09-14 10:05:37 -0400281 assert((opcode.numTypes < maxNumOperands) &&
282 "Operand class list is too long. Expand "
283 "spv_opcode_desc_t.operandClass");
David Neto78c3b432015-08-27 13:03:52 -0400284 }
David Neto78c3b432015-08-27 13:03:52 -0400285}
286
Lei Zhang1a0334e2015-11-02 09:41:20 -0500287const char* spvGeneratorStr(uint32_t generator) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100288 switch (generator) {
289 case SPV_GENERATOR_KHRONOS:
290 return "Khronos";
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100291 case SPV_GENERATOR_LUNARG:
292 return "LunarG";
David Neto1780fc42015-10-26 15:43:12 -0400293 case SPV_GENERATOR_VALVE:
294 return "Valve";
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100295 case SPV_GENERATOR_CODEPLAY:
296 return "Codeplay Software Ltd.";
David Neto1780fc42015-10-26 15:43:12 -0400297 case SPV_GENERATOR_NVIDIA:
298 return "NVIDIA";
299 case SPV_GENERATOR_ARM:
300 return "ARM";
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100301 default:
302 return "Unknown";
303 }
304}
305
Lei Zhangb36e7042015-10-28 13:40:52 -0400306uint32_t spvOpcodeMake(uint16_t wordCount, SpvOp opcode) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100307 return ((uint32_t)opcode) | (((uint32_t)wordCount) << 16);
308}
309
Lei Zhang1a0334e2015-11-02 09:41:20 -0500310void spvOpcodeSplit(const uint32_t word, uint16_t* pWordCount, SpvOp* pOpcode) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100311 if (pWordCount) {
312 *pWordCount = (uint16_t)((0xffff0000 & word) >> 16);
313 }
314 if (pOpcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400315 *pOpcode = (SpvOp)(0x0000ffff & word);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100316 }
317}
318
Lei Zhang1a0334e2015-11-02 09:41:20 -0500319spv_result_t spvOpcodeTableGet(spv_opcode_table* pInstTable) {
Lei Zhang40056702015-09-11 14:31:27 -0400320 if (!pInstTable) return SPV_ERROR_INVALID_POINTER;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100321
Lei Zhang972788b2015-11-12 13:48:30 -0500322 const uint32_t size = sizeof(opcodeTableEntries);
323 spv_opcode_desc_t* copied_entries =
324 static_cast<spv_opcode_desc_t*>(::malloc(size));
325 if (!copied_entries) return SPV_ERROR_OUT_OF_MEMORY;
326 ::memcpy(copied_entries, opcodeTableEntries, size);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100327
Lei Zhang972788b2015-11-12 13:48:30 -0500328 const uint32_t count = sizeof(opcodeTableEntries) / sizeof(spv_opcode_desc_t);
329 spv_opcode_table_t* table = new spv_opcode_table_t{count, copied_entries};
David Neto78c3b432015-08-27 13:03:52 -0400330
Lei Zhang972788b2015-11-12 13:48:30 -0500331 spvOpcodeTableInitialize(copied_entries, count);
332
333 *pInstTable = table;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100334
335 return SPV_SUCCESS;
336}
337
338spv_result_t spvOpcodeTableNameLookup(const spv_opcode_table table,
Lei Zhang1a0334e2015-11-02 09:41:20 -0500339 const char* name,
340 spv_opcode_desc* pEntry) {
Lei Zhang40056702015-09-11 14:31:27 -0400341 if (!name || !pEntry) return SPV_ERROR_INVALID_POINTER;
342 if (!table) return SPV_ERROR_INVALID_TABLE;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100343
344 // TODO: This lookup of the Opcode table is suboptimal! Binary sort would be
345 // preferable but the table requires sorting on the Opcode name, but it's
346 // static
347 // const initialized and matches the order of the spec.
348 const size_t nameLength = strlen(name);
349 for (uint64_t opcodeIndex = 0; opcodeIndex < table->count; ++opcodeIndex) {
350 if (nameLength == strlen(table->entries[opcodeIndex].name) &&
351 !strncmp(name, table->entries[opcodeIndex].name, nameLength)) {
352 // NOTE: Found out Opcode!
353 *pEntry = &table->entries[opcodeIndex];
354 return SPV_SUCCESS;
355 }
356 }
357
358 return SPV_ERROR_INVALID_LOOKUP;
359}
360
361spv_result_t spvOpcodeTableValueLookup(const spv_opcode_table table,
Lei Zhangb36e7042015-10-28 13:40:52 -0400362 const SpvOp opcode,
Lei Zhang1a0334e2015-11-02 09:41:20 -0500363 spv_opcode_desc* pEntry) {
Lei Zhang40056702015-09-11 14:31:27 -0400364 if (!table) return SPV_ERROR_INVALID_TABLE;
365 if (!pEntry) return SPV_ERROR_INVALID_POINTER;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100366
367 // TODO: As above this lookup is not optimal.
368 for (uint64_t opcodeIndex = 0; opcodeIndex < table->count; ++opcodeIndex) {
369 if (opcode == table->entries[opcodeIndex].opcode) {
370 // NOTE: Found the Opcode!
371 *pEntry = &table->entries[opcodeIndex];
372 return SPV_SUCCESS;
373 }
374 }
375
376 return SPV_ERROR_INVALID_LOOKUP;
377}
378
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100379int32_t spvOpcodeRequiresCapabilities(spv_opcode_desc entry) {
David Neto9db3a532015-10-07 16:58:38 -0400380 return entry->capabilities != 0;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100381}
382
Lei Zhang1a0334e2015-11-02 09:41:20 -0500383void spvInstructionCopy(const uint32_t* words, const SpvOp opcode,
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100384 const uint16_t wordCount, const spv_endianness_t endian,
Lei Zhang1a0334e2015-11-02 09:41:20 -0500385 spv_instruction_t* pInst) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100386 pInst->opcode = opcode;
David Netob5dc8fc2015-10-06 16:22:00 -0400387 pInst->words.resize(wordCount);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100388 for (uint16_t wordIndex = 0; wordIndex < wordCount; ++wordIndex) {
389 pInst->words[wordIndex] = spvFixWord(words[wordIndex], endian);
390 if (!wordIndex) {
391 uint16_t thisWordCount;
Lei Zhangb36e7042015-10-28 13:40:52 -0400392 SpvOp thisOpcode;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100393 spvOpcodeSplit(pInst->words[wordIndex], &thisWordCount, &thisOpcode);
394 assert(opcode == thisOpcode && wordCount == thisWordCount &&
395 "Endianness failed!");
396 }
397 }
398}
399
Lei Zhang1a0334e2015-11-02 09:41:20 -0500400const char* spvOpcodeString(const SpvOp opcode) {
David Neto201caf72015-11-04 17:38:17 -0500401// Use the syntax table so it's sure to be complete.
David Neto1bcd3d12015-11-02 16:03:12 -0500402#define Instruction(Name, ...) \
403 case SpvOp##Name: \
404 return #Name;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100405 switch (opcode) {
David Neto1bcd3d12015-11-02 16:03:12 -0500406#include "opcode.inc"
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100407 default:
408 assert(0 && "Unreachable!");
409 }
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100410 return "unknown";
David Neto1bcd3d12015-11-02 16:03:12 -0500411#undef Instruction
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100412}
413
Lei Zhangb36e7042015-10-28 13:40:52 -0400414int32_t spvOpcodeIsScalarType(const SpvOp opcode) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100415 switch (opcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400416 case SpvOpTypeInt:
417 case SpvOpTypeFloat:
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100418 return true;
419 default:
420 return false;
421 }
422}
423
Lei Zhangb36e7042015-10-28 13:40:52 -0400424int32_t spvOpcodeIsConstant(const SpvOp opcode) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100425 switch (opcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400426 case SpvOpConstantTrue:
427 case SpvOpConstantFalse:
428 case SpvOpConstant:
429 case SpvOpConstantComposite:
430 case SpvOpConstantSampler:
431 // case SpvOpConstantNull:
432 case SpvOpConstantNull:
433 case SpvOpSpecConstantTrue:
434 case SpvOpSpecConstantFalse:
435 case SpvOpSpecConstant:
436 case SpvOpSpecConstantComposite:
437 // case SpvOpSpecConstantOp:
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100438 return true;
439 default:
440 return false;
441 }
442}
443
Lei Zhangb36e7042015-10-28 13:40:52 -0400444int32_t spvOpcodeIsComposite(const SpvOp opcode) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100445 switch (opcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400446 case SpvOpTypeVector:
447 case SpvOpTypeMatrix:
448 case SpvOpTypeArray:
449 case SpvOpTypeStruct:
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100450 return true;
451 default:
452 return false;
453 }
454}
455
Lei Zhang1a0334e2015-11-02 09:41:20 -0500456int32_t spvOpcodeAreTypesEqual(const spv_instruction_t* pTypeInst0,
457 const spv_instruction_t* pTypeInst1) {
Lei Zhang40056702015-09-11 14:31:27 -0400458 if (pTypeInst0->opcode != pTypeInst1->opcode) return false;
459 if (pTypeInst0->words[1] != pTypeInst1->words[1]) return false;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100460 return true;
461}
462
Lei Zhangb36e7042015-10-28 13:40:52 -0400463int32_t spvOpcodeIsPointer(const SpvOp opcode) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100464 switch (opcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400465 case SpvOpVariable:
466 case SpvOpAccessChain:
467 case SpvOpInBoundsAccessChain:
468 case SpvOpFunctionParameter:
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100469 return true;
470 default:
471 return false;
472 }
473}
474
Lei Zhangb36e7042015-10-28 13:40:52 -0400475int32_t spvOpcodeIsObject(const SpvOp opcode) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100476 switch (opcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400477 case SpvOpConstantTrue:
478 case SpvOpConstantFalse:
479 case SpvOpConstant:
480 case SpvOpConstantComposite:
481 // TODO: case SpvOpConstantSampler:
482 case SpvOpConstantNull:
483 case SpvOpSpecConstantTrue:
484 case SpvOpSpecConstantFalse:
485 case SpvOpSpecConstant:
486 case SpvOpSpecConstantComposite:
487 // TODO: case SpvOpSpecConstantOp:
488 case SpvOpVariable:
489 case SpvOpAccessChain:
490 case SpvOpInBoundsAccessChain:
491 case SpvOpConvertFToU:
492 case SpvOpConvertFToS:
493 case SpvOpConvertSToF:
494 case SpvOpConvertUToF:
495 case SpvOpUConvert:
496 case SpvOpSConvert:
497 case SpvOpFConvert:
498 case SpvOpConvertPtrToU:
499 // TODO: case SpvOpConvertUToPtr:
500 case SpvOpPtrCastToGeneric:
501 // TODO: case SpvOpGenericCastToPtr:
502 case SpvOpBitcast:
503 // TODO: case SpvOpGenericCastToPtrExplicit:
504 case SpvOpSatConvertSToU:
505 case SpvOpSatConvertUToS:
506 case SpvOpVectorExtractDynamic:
507 case SpvOpCompositeConstruct:
508 case SpvOpCompositeExtract:
509 case SpvOpCopyObject:
510 case SpvOpTranspose:
511 case SpvOpSNegate:
512 case SpvOpFNegate:
513 case SpvOpNot:
514 case SpvOpIAdd:
515 case SpvOpFAdd:
516 case SpvOpISub:
517 case SpvOpFSub:
518 case SpvOpIMul:
519 case SpvOpFMul:
520 case SpvOpUDiv:
521 case SpvOpSDiv:
522 case SpvOpFDiv:
523 case SpvOpUMod:
524 case SpvOpSRem:
525 case SpvOpSMod:
526 case SpvOpVectorTimesScalar:
527 case SpvOpMatrixTimesScalar:
528 case SpvOpVectorTimesMatrix:
529 case SpvOpMatrixTimesVector:
530 case SpvOpMatrixTimesMatrix:
531 case SpvOpOuterProduct:
532 case SpvOpDot:
533 case SpvOpShiftRightLogical:
534 case SpvOpShiftRightArithmetic:
535 case SpvOpShiftLeftLogical:
536 case SpvOpBitwiseOr:
537 case SpvOpBitwiseXor:
538 case SpvOpBitwiseAnd:
539 case SpvOpAny:
540 case SpvOpAll:
541 case SpvOpIsNan:
542 case SpvOpIsInf:
543 case SpvOpIsFinite:
544 case SpvOpIsNormal:
545 case SpvOpSignBitSet:
546 case SpvOpLessOrGreater:
547 case SpvOpOrdered:
548 case SpvOpUnordered:
549 case SpvOpLogicalOr:
550 case SpvOpLogicalAnd:
551 case SpvOpSelect:
552 case SpvOpIEqual:
553 case SpvOpFOrdEqual:
554 case SpvOpFUnordEqual:
555 case SpvOpINotEqual:
556 case SpvOpFOrdNotEqual:
557 case SpvOpFUnordNotEqual:
558 case SpvOpULessThan:
559 case SpvOpSLessThan:
560 case SpvOpFOrdLessThan:
561 case SpvOpFUnordLessThan:
562 case SpvOpUGreaterThan:
563 case SpvOpSGreaterThan:
564 case SpvOpFOrdGreaterThan:
565 case SpvOpFUnordGreaterThan:
566 case SpvOpULessThanEqual:
567 case SpvOpSLessThanEqual:
568 case SpvOpFOrdLessThanEqual:
569 case SpvOpFUnordLessThanEqual:
570 case SpvOpUGreaterThanEqual:
571 case SpvOpSGreaterThanEqual:
572 case SpvOpFOrdGreaterThanEqual:
573 case SpvOpFUnordGreaterThanEqual:
574 case SpvOpDPdx:
575 case SpvOpDPdy:
576 case SpvOpFwidth:
577 case SpvOpDPdxFine:
578 case SpvOpDPdyFine:
579 case SpvOpFwidthFine:
580 case SpvOpDPdxCoarse:
581 case SpvOpDPdyCoarse:
582 case SpvOpFwidthCoarse:
583 case SpvOpReturnValue:
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100584 return true;
585 default:
586 return false;
587 }
588}
589
Lei Zhangb36e7042015-10-28 13:40:52 -0400590int32_t spvOpcodeIsBasicTypeNullable(SpvOp opcode) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100591 switch (opcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400592 case SpvOpTypeBool:
593 case SpvOpTypeInt:
594 case SpvOpTypeFloat:
595 case SpvOpTypePointer:
596 case SpvOpTypeEvent:
597 case SpvOpTypeDeviceEvent:
598 case SpvOpTypeReserveId:
599 case SpvOpTypeQueue:
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100600 return true;
601 default:
602 return false;
603 }
604}
605
Lei Zhang1a0334e2015-11-02 09:41:20 -0500606int32_t spvInstructionIsInBasicBlock(const spv_instruction_t* pFirstInst,
607 const spv_instruction_t* pInst) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100608 while (pFirstInst != pInst) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400609 if (SpvOpFunction == pInst->opcode) break;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100610 pInst--;
611 }
Lei Zhangb36e7042015-10-28 13:40:52 -0400612 if (SpvOpFunction != pInst->opcode) return false;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100613 return true;
614}
615
Lei Zhangb36e7042015-10-28 13:40:52 -0400616int32_t spvOpcodeIsValue(SpvOp opcode) {
Lei Zhang40056702015-09-11 14:31:27 -0400617 if (spvOpcodeIsPointer(opcode)) return true;
618 if (spvOpcodeIsConstant(opcode)) return true;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100619 switch (opcode) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400620 case SpvOpLoad:
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100621 // TODO: Other Opcode's resulting in a value
622 return true;
623 default:
624 return false;
625 }
626}
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400627
Lei Zhangb36e7042015-10-28 13:40:52 -0400628int32_t spvOpcodeGeneratesType(SpvOp op) {
Lei Zhang1a0334e2015-11-02 09:41:20 -0500629 switch (op) {
Lei Zhangb36e7042015-10-28 13:40:52 -0400630 case SpvOpTypeVoid:
631 case SpvOpTypeBool:
632 case SpvOpTypeInt:
633 case SpvOpTypeFloat:
634 case SpvOpTypeVector:
635 case SpvOpTypeMatrix:
636 case SpvOpTypeImage:
637 case SpvOpTypeSampler:
638 case SpvOpTypeSampledImage:
639 case SpvOpTypeArray:
640 case SpvOpTypeRuntimeArray:
641 case SpvOpTypeStruct:
642 case SpvOpTypeOpaque:
643 case SpvOpTypePointer:
644 case SpvOpTypeFunction:
645 case SpvOpTypeEvent:
646 case SpvOpTypeDeviceEvent:
647 case SpvOpTypeReserveId:
648 case SpvOpTypeQueue:
649 case SpvOpTypePipe:
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400650 return true;
David Netoaef608c2015-11-02 14:59:02 -0500651 default:
652 // In particular, OpTypeForwardPointer does not generate a type,
653 // but declares a storage class for a pointer type generated
654 // by a different instruction.
655 break;
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400656 }
657 return 0;
658}