spv_operand_type_t cleanup.

- Concrete operand types are never optional.
  Split them to make this so, e.g. add SPV_OPERAND_TYPE_IMAGE
  since there was SPV_OPERAND_TYPE_OPTIONAL_IMAGE.
  Similarly for SPV_OPERAND_TYPE_MEMORY_ACCESS.
  This entails duplicating two operand table entries.

- The above, plus some rearranging of enums, allows us to define
  first and last optional operand types, and first and last
  variable operand types.
  This lets us simplify the code for spvOperandIsOptional, and
  spvOperandIsVariable.

- Replace SPV_OPERAND_TYPE_MULTIWORD_LITERAL_NUMBER with the
  more accurately named SPV_OPERAND_TYPE_TYPED_LITERAL_NUMBER.
  Its special characteristic is that the type of the literal
  number is determined by some previous operand in the instruction.
  This is used for literals in OpSwitch, OpConstant, and OpSpecConstant.
  This lets us refactor operand parsing cases in the assembler.

- Remove the special required-thing-in-optional-tuple in favour of
  the corresponding concrete operand type:
        SPV_OPERAND_TYPE_ID_IN_OPTIONAL_TUPLE
    --> SPV_OPERAND_TYPE_ID
        SPV_OPERAND_TYPE_INTEGER_LITERAL_IN_OPTIONAL_TUPLE
    --> SPV_OPERAND_TYPE_INTEGER_LITERAL

- Constrain spvOpeandTypeStr to only have to work for non-variable
  operand types.  Add a test for this.

Remove TODO: Strings are always little-endian

SPIR-V strings are UTF-8 encoded, and always byte-addressed.

Refactor the binary parser.

The binary parser has a C API, described in binary.h.
Eventually we will make it public in libspirv.h.
The API is event-driven in the sense that a callback is called
when a valid header is parsed, and for each parsed instruction.

Classify some operand types as "concrete".  The binary parser uses
only concrete operand types to describe parsed instructions.

The old disassembler APIs are moved into disassemble.cpp

TODO: Add unit tests for spvBinaryParse.

Slay "undeflow."

Refactor EncodeTestHelper() and DecodeTestHelper().

Consts before the type, not after

A spv_binary_t points to const code words.

Move spvBinaryToText into new disassembler file.

This begins the refactoring of the disassembler into
two parts: A binary decoder in binary.cpp, and an
event-driven converter to text in disassemble.cpp

Use the syntax table for opcode to name mappings.

This method is more reliably complete.

Updated comment in SetBits.

It now mentions that it will fail if you try to set a bit that
does not exist.

DiagnosticStream keeps a copy of the position.

Don't store the pointer, as the underlying storage
could disappear.  This a bit more flexible and robust.

Added double tests to HexFloat

Empty assembly text compiles to no instructions.

But it's still a valid module.

Consolidate: spvOpcodeIsType into spvOpcodeGeneratesType

And fix the spvOpcodeGeneratesType: OpTypeForwardPointer
does not generate a new type.

Run clang-format to enforce Google style globally.

Note that we are more strict than Google style for one aspect:
pointer/reference indicators are adjacent to their types, not
their variables.

find . -name "*.h" -exec clang-format -i {} \;
find . -name "*.cpp" -exec clang-format -i {} \;

Update readme: fix utf-8 tests, use spirv.h

Updated HexFloat parsing for windows.

It is valid for float values to be modified on copy if they are NaN,
so long as they remain the correct NaN. What this means is that
we can not rely on the float data-type for storing float values
if we want to retain bit patterns.

Added FloatProxy which stores data in an unsigned integer, and updated
the HexFloat template to deal with FloatProxy values instead.

Added HexFloat reading to HexFloat.

This allows reading of hex-encoded floats.

Added HexFloat helper class to print out floating point numbers.

TODO Add double tests before we actually use this.

Changed SetBits to index from LSB and take a size.

Use spirv.h instead of spirv.hpp.

This is a part of the effort to make libspirv.h C-compatible.

Inclusion guards follow Google C++ style

Follow the scheme in
http://google-styleguide.googlecode.com/svn/trunk/cppguide.html#The__define_Guard
except:
 - 'include/' is dropped from the guard token
 - 'source/' is dropped from the guard token

Move endian utilities to their own file.

Hide spvBinaryHeaderSet with its only client.

Also rename it to SetHeader since it's not part of the "binary"
API.

Move AssemblyGrammar into its own source files

Add DISABLED failing test for ext inst import confusion

Currently, the assembler does not track external import
IDs when there are two or more.

TODO(dneto): Fix this functionality.

Use basic_string<char> for the UTF-8 test string

This is an attempt to fix the unit tests on DeveloperStudio 2013.
Currently, the size of the earth_africa string is reported as 2
on Windows.  But I think that may be 2 16-bit characters.

Update to latest registered generator enums

The registry is at:
https://www.khronos.org/registry/spir-v/api/spir-v.xml

Added set_bits<> to bitutils.

This allows us to get a constant with the given bits set at
compile-time. This is needed for a future patch for HexFloat.

Test cleanup: remove useless std::string constructor

Use typedef instead of using in libspirv.h.

The header file should be compatible with pre-C++11 code.

Merge branch 'google-asm-dis-oct-25' into 'master'

Google assembler disassembler catchup to oct 25

Catches up with the google branch through 2015-10-25:

* SPIR-V 0.99 Rev32
   * Core instructions, enumerants, and capabilities
* GLSL std450 extended instructions supported
* OpenCL extended instruction supported, version 1.0 Revision 1

See readme.md for missing features and known bugs, e.g.
* Fix disassembler support for non-32 bit numeric literals
* Fix: Assembler can't use extended instructions from two different imports
  in the same module
* TODO: 16-bit floating point literals

See merge request !10

Fix readme: this is not the 'google' branch

Fix GMOCK directory in CMakeLists.txt.

Fixed typo in utf8 string literal

Fixed UTF-8 encoding issues on windows.

Also cleaned up some warnings related to implicit size_t/uint64_t
conversions.

Added type tracking to the disassembler.

TODO: Actually use the tracked types to make sure that we print out
values correctly.

Update readme: Support OpenCL, UTF-8 literal strings

Remaining tests for OpenCL extended instructions.

Add operand type for extension instruction number

This is required to support extended instructions that
have literal numbers as operands.  An example is OpenCL's
vloadn.

The previous code in the assembler assumed that *any* literal
number argument in any part of an OpExtInst must be the name
of the extended instruction.  That's true only for the first
literal number argument.

Use literal integers for OpenCL extended instructions.

Add OpenCL extended instructions.

Versions 1.2, 2.0, and 2.1 all use the same
extended instruction list.

Updated the source code patch for the SPIR-V doc generator,
so it can both generate the core syntax table, and also the
OpenCL extended instructions table.

Tested the Math and Common functions.
TODO: test the remaining entries.

Some minor clean-ups to binary.{h,cpp}.

Removed spvBinaryDecodeOpcode and spvBinaryDecodeOperand from the public
interface since they were only ever used in binary.cpp.

Replaced the usage of spv_operand_table_t and it's ilk with the
AssemblyGrammar to reduce the number of passed parameters.

Fixed typo in comment.

Enforce suitable literal number operands to be unsigned integers.

Except for OpConstant and OpSpecConstant, all other literal number
operands are indeed unsigned integers. So,

* Rename all *LITERAL_NUMBER* operand types to *LITERAL_INTEGER*.
* Expect unsigned integers for *LITERAL_INTEGER* operands.
* Keep MULITPLE_WORD_LITERAL untouched since it is only used by
  OpConstant and OpSpecConstant.

And we want to provide the capability to specify floating-point
numbers after !<integer> in the alternate parsing mode. So,
OPTIONAL_LITERAL_NUMBER is reserved for OPTIONAL_CIV.

Git ignore compile_commands.json in root directory.

Useful for standalone development of SPIR-V Tools with
Ninja and YouCompleteMe.

Use normal string instead of raw string for simple strings.

Simplify methods for compilation failure in test framework.

Remove  CompileWithFormatFailure() and make CompileFailure() accept
a default argument.

Use SPIRV_PERF=1 when performance tuning.

It tells the compiler to keep frame pointers, so you have good
call stacks in your profiles.

Avoid strlen in a loop, for speed.

Fix Android build: use std::numeric_limits<T>::max and friends

UINT32_MAX and friends are not available.

Add disabled tests for disassembler literal emission

Currently, negative numbers are printed as if they were
first statically cast to unsigned.

Added proper string escaping to the disassembler.

The disassembler now generates correct string when encountering
quotes and slashes.

SPV_FAILED_MATCH error mutes DiagnosticStream.

The DiagnosticStream will not emit the accumulated message
text if the error is SPV_FAILED_MATCH.

Change various interfaces to accept the intended error
code instead of a boolean "is_optional".  This allows
us to avoid repeating the following type of logic deep
inside helper methods:

  if (is_optional) return SPV_FAILED_MATCH;
  return diagnostic() << " message text ";

Removed un-needed comments and fixed merge issue.

Updated string escaping in the assembler.

Strings are now escaped correctly when assembling.
TODO dissassembler support for strange strings (newlines for example).

Update readme. Long instructions, literal number encoding

Add negative-coverage location to operand-class-test-coverage.csv.

Parse and encode literal integers to the right width

Affects OpConstant, and OpSwitch.

Adds constant libspirv::kUnknownType for readability.

Adds tests for hexadecimal number parsing.

Updates syntax.md to describe hex parsing, including
sign extension.

Add AssemblyContext::parseNumber

It parses a text string for a value of a given target type.

DiagnosticStream can convert to a stored error code

Use this to shorten error return code in the assembler.

For example, change this:

   if (error = something()) {
      diagnostic() << " Bad integer literal " << value;
      return SPV_ERROR_INVALID_VALUE;
   }

to this:

   if (error = something())
      return diagnostic() << " Bad integer literal " << value;

Also shorten code due to the fact that binaryEncodeU32 and
binaryCodeU64 can't fail (short of failure to expand a std::vector).

Negative test for FunctionControl.

Negative test for LoopControl.

Negative test for SelectionControl.

Negative test for GroupOperation.

Negative test for LinkageType.

Negative test for BuiltIn.

Negative test for AccessQualifier.

Negative test for FuncParamAttr.

Negative test for Decoration.

Negative test for FPRoundingMode.

Negative test for FPFastMathMode.

Negative test for ImageFormat.

Make compilation input strings const.

Also rerun clang-format.

Negative test for SamplerFilterMode.

Negative test for SamplerAddressingMode.

Clarify handling of OperandImageOperands.

Negative test for ImageOperands.

Negative test for Dim.

Test OpTypeForwardPointer.

Added tracking to types and validated certain instructions.

We need to know how to generate correct SPIRV for cases like
OpConstant %int64 42 since the current parser will encode the 42 as a
32-bit value incorrectly.

This change is the first of a pair. This one tracks types, and makes
sure that OpConstant and OpSpecConstant are only ever called with
Integer or Float types, and OpSwitch is only called with integer
generating values.

Remove spv_opcode_flags_t and flags fields.

The flags fields in both spv_opcode_desc_t and spv_operand_desc_t
are redundant with the capabilities mask field in the same
structure.

Negative test for ExecutionMode.

Negative test for AddressingModel, MemoryModel.

Negative test for ExecutionModel.

Negative test for SourceLanguage.

Also, use "class" instead of "type" in the coverage CSV.

Accept long UTF-8 Literal Strings

Support strings with up to 65535 chars, and null.

Move the definition of spv_instruction_t to an internal
header file, since it now depends on C++ and is not
used by the external interface.

Use a std::vector<uint32_t> in spv_instruction_t
instead of a fixed size array.

Remove stale TODO. Fix use of OpCode to 'instruction'

Update readme: capabilities are up to date

Define spv_capability_mask_t for readability.

Test capabilities for enums sections 3.21-3.31

Fixes dependencies among capabilities.  (The table should store
the mask of capabilites, not the capability enum.)

Remove the old spot check test for capabilities of enums.

Fix capabilities for enums in Rev32, sec 3.3-3.20

Move AutoText and EnumCase into spvtest namespace

Also fix using declaration order.
Also put a few tests into the anonymous namespace.

Update readme: Finish assembler !<integer> support

Also internal cleanups and additional tests.

Test operand-table capabilities.

Add TODO for fixing endianness testing.

Currently it uses a union, a write to one field, and read from
another of a different type.

Moves the endianness-determining macro close to the variable
it references.

Test SPV_CAPABILITY_AS_MASK macro

Use 3-arg MakeInstruction to reduce logic in tests

Avoids open-coded vector inserts and two variables in various
tests.  Should improve readability.

Test opcode table capability entries.

Make capabilities a bitfield in opcode/operand tables.