pmfx_pipeline.py

import pmfx as build_pmfx
import cgu
import os
import json
import hashlib
import zlib
import sys
import jsn

from multiprocessing.pool import ThreadPool

# replace warning string with colour coded warning:
def replace_warning(msg):
    WARNING = '\033[93m'
    ENDC = '\033[0m'
    return msg.replace("warning:", WARNING + "warning:" + ENDC)


# replace error string with colour coded error:
def replace_error(msg):
    ERROR = '\033[91m'
    ENDC = '\033[0m'
    return msg.replace("error:", ERROR + "error:" + ENDC)


# colour code the squiggles as warnings
def squiggle_warning(msg):
    WARNING = '\033[93m'
    ENDC = '\033[0m'
    return WARNING + msg + ENDC


# colour code the squiggles as errors
def squiggle_error(msg):
    ERROR = '\033[91m'
    ENDC = '\033[0m'
    return ERROR + msg + ENDC


# return a 32 bit hash from objects which can cast to str
def pmfx_hash(src):
    return zlib.adler32(bytes(str(src).encode("utf8")))


# combine 2, 32 bit hashes
def pmfx_hash_combine(h1: int, h2: int) -> int:
    combined_data = h1.to_bytes(4, 'little') + h2.to_bytes(4, 'little')
    return zlib.adler32(combined_data)


# return names of supported shader stages
def get_shader_stages():
    return [
        "vs",
        "ps",
        "cs",
        "lib"
    ]


# return the key of state groups, specified in pmfx
def get_states():
    return [
        "depth_stencil_states",
        "sampler_states",
        "render_target_blend_states",
        "blend_states",
        "raster_states",
        "textures",
        "views",
        "update_graphs",
        "render_graphs"
    ]


# return a lits of bindabled resource keywords
def get_bindable_resource_keys():
    return [
        "cbuffer",
        "ConstantBuffer",
        "StructuredBuffer",
        "ByteAddressBuffer",
        "RWStructuredBuffer",
        "RWByteAddressBuffer",
        "AppendStructuredBuffer",
        "ConsumeStructuredBuffer",
        "Texture1D",
        "Texture1DArray",
        "Texture2D",
        "Texture2DArray",
        "Texture2DMS",
        "Texture2DMSArray",
        "TextureCube",
        "TextureCubeArray",
        "Texture3D",
        "RWTexture1D",
        "RWTexture1DArray",
        "RWTexture2D",
        "RWTexture2DArray",
        "RWTexture3D",
        "SamplerState",
        "SamplerComparisonState",
        "RaytracingAccelerationStructure"
    ]


# resource keyword to categroy mapping
def get_resource_mappings():
    return [
        {"category": "structs", "identifier": "struct"},
        {"category": "cbuffers", "identifier": "cbuffer"},
        {"category": "cbuffers", "identifier": "ConstantBuffer"},
        {"category": "samplers", "identifier": "SamplerState"},
        {"category": "samplers", "identifier": "SamplerComparisonState"},
        {"category": "structured_buffers", "identifier": "StructuredBuffer"},
        {"category": "structured_buffers", "identifier": "ByteAddressBuffer"},
        {"category": "structured_buffers", "identifier": "AppendStructuredBuffer"},
        {"category": "structured_buffers", "identifier": "ConsumeStructuredBuffer"},
        {"category": "structured_buffers", "identifier": "RWStructuredBuffer"},
        {"category": "structured_buffers", "identifier": "RWByteAddressBuffer"},
        {"category": "textures", "identifier": "Texture1D"},
        {"category": "textures", "identifier": "Texture1DArray"},
        {"category": "textures", "identifier": "Texture2D"},
        {"category": "textures", "identifier": "Texture2DArray"},
        {"category": "textures", "identifier": "Texture2DMS"},
        {"category": "textures", "identifier": "Texture2DMSArray"},
        {"category": "textures", "identifier": "TextureCube"},
        {"category": "textures", "identifier": "TextureCubeArray"},
        {"category": "textures", "identifier": "Texture3D"},
        {"category": "textures", "identifier": "RWTexture1D"},
        {"category": "textures", "identifier": "RWTexture1DArray"},
        {"category": "textures", "identifier": "RWTexture2D"},
        {"category": "textures", "identifier": "RWTexture2DArray"},
        {"category": "textures", "identifier": "RWTexture3D"},
        {"category": "acceleration_structures", "identifier": "RaytracingAccelerationStructure"},
    ]


# return list of resource categories
def get_resource_categories():
    return [
        "structs",
        "cbuffers",
        "structured_buffers",
        "textures",
        "samplers",
        "acceleration_structures"
    ]


# return global types we want to check for within source
def get_global_types():
    return [
        "groupshared"
    ]


# returns info for types, (num_elements, element_size, total_size)
def get_type_size_info(type):
    lookup = {
        "float": (1, 4, 4),
        "float2": (2, 4, 8),
        "float3": (3, 4, 12),
        "float4": (4, 4, 16),
        "float2x2": (8, 4, 32),
        "float3x4": (12, 4, 48),
        "float4x3": (12, 4, 48),
        "float4x4": (16, 4, 64),
        "int": (1, 4, 4),
        "int2": (2, 4, 8),
        "int3": (3, 4, 12),
        "int4": (4, 4, 16),
        "uint": (1, 4, 4),
        "uint2": (2, 4, 8),
        "uint3": (3, 4, 12),
        "uint4": (4, 4, 16),
    }
    return lookup[type]


# return number of 32 bit values for a member of a push constants cbuffer
def get_num_32bit_values(type):
    lookup = {
        "float": 1,
        "float2": 2,
        "float3": 3,
        "float4": 4,
        "float2x2": 8,
        "float3x4": 12,
        "float4x3": 12,
        "float4x4": 16,
        "int": 1,
        "int2": 2,
        "int3": 3,
        "int4": 4,
        "uint": 1,
        "uint2": 2,
        "uint3": 3,
        "uint4": 4,
    }
    if type in lookup:
        return lookup[type]
    return 0


# returns a vertex format type from the data type
def vertex_format_from_type(type):
    lookup = {
        "float": "R32f",
        "float2": "RG32f",
        "float3": "RGB32f",
        "float4": "RGBA32f",
        "half": "R16f",
        "half2": "RG16f",
        "half3": "RGB16f",
        "half4": "RGBA16f",
        "int": "R32i",
        "int2": "RG32i",
        "int3": "RGB32i",
        "int4": "RGBA32i",
        "uint": "R32u",
        "uint2": "RG32u",
        "uint3": "RGB32u",
        "uint4": "RGBA32u",
    }
    if type in lookup:
        return lookup[type]
    assert(0)
    return "Unknown"


# shader visibility can be on a single stage or all
def get_shader_visibility(vis):
    if len(vis) == 1:
        stages = {
            "vs": "Vertex",
            "ps": "Fragment",
            "cs": "Compute",
        }
        if vis[0] in stages:
            return stages[vis[0]]
    return "All"


# return the binding type from hlsl register names
def get_binding_type(register_type):
    type_lookup = {
        "t": "ShaderResource",
        "b": "ConstantBuffer",
        "u": "UnorderedAccess",
        "s": "Sampler"
    }
    return type_lookup[register_type]


# assign default values to all struct members
def get_state_with_defaults(state_type, state):
    state_defaults = {
        "depth_stencil_states": {
            "depth_enabled": False,
            "depth_write_mask": "Zero",
            "depth_func": "Always",
            "stencil_enabled": False,
            "stencil_read_mask": 0,
            "stencil_write_mask": 0,
            "front_face": {
                "fail": "Keep",
                "depth_fail": "Keep",
                "pass": "Keep",
                "func": "Always"
            },
            "back_face": {
                "fail": "Keep",
                "depth_fail": "Keep",
                "pass": "Keep",
                "func": "Always"
            }
        },
        "sampler_states": {
            "filter": "Linear",
            "address_u": "Wrap",
            "address_v": "Wrap",
            "address_w": "Wrap",
            "comparison": None,
            "border_colour": None,
            "mip_lod_bias": 0.0,
            "max_aniso": 0,
            "min_lod": 0.0,
            "max_lod": sys.float_info.max
        },
        "render_target_blend_states": {
            "blend_enabled": False,
            "logic_op_enabled": False,
            "src_blend": "Zero",
            "dst_blend": "Zero",
            "blend_op": "Add",
            "src_blend_alpha": "Zero",
            "dst_blend_alpha": "Zero",
            "blend_op_alpha": "Add",
            "logic_op": "Clear",
            "write_mask": {
                "bits": (1<<0)|(1<<1)|(1<<2)
            }
        },
        "blend_states": {
            "alpha_to_coverage_enabled": False,
            "independent_blend_enabled": False,
            "render_targets": []
        },
        "raster_states": {
            "fill_mode": "Solid",
            "cull_mode": "None",
            "front_ccw": False,
            "depth_bias": 0,
            "depth_bias_clamp": 0.0,
            "slope_scaled_depth_bias": 0.0,
            "depth_clip_enable": False,
            "multisample_enable": False,
            "antialiased_line_enable": False,
            "forced_sample_count": 0,
            "conservative_raster_mode": False,
        },
        "textures": {
            "format": "RGBA8n",
            "width": 1,
            "height": 1,
            "depth": 1,
            "array_layers": 1,
            "mip_levels": 1,
            "samples": 1,
            "cubemap": False,
            "usage": ["ShaderResource"]
        },
        "views": {
            "viewport": [0.0, 0.0, 1.0, 1.0, 0.0, 1.0],
            "scissor": [0.0, 0.0, 1.0, 1.0],
            "render_target": list(),
            "depth_stencil": list(),
        }
    }

    # converts write_mask: RGBA to bits
    if state_type == "render_target_blend_states":
        if "write_mask" in state:
            bits = 0
            if state["write_mask"] == "All":
                bits = (1<<4)-1
            elif state["write_mask"] != "None":
                if "R" in state["write_mask"]:
                    bits |= (1<<0)
                if "G" in state["write_mask"]:
                    bits |= (1<<1)
                if "B" in state["write_mask"]:
                    bits |= (1<<2)
                if "A" in state["write_mask"]:
                    bits |= (1<<3)
            state["write_mask"] = {
                "bits": bits
            }

    if state_type in state_defaults:
        default = dict(state_defaults[state_type])
        state = merge_dicts(default, state)
        state["hash"] = pmfx_hash(state)
    return state


# get pipeline with defaults
def get_pipeline_with_defaults(output_pipeline, pipeline):
    # topology
    if "topology" in pipeline:
        output_pipeline["topology"] = pipeline["topology"]
    else:
        output_pipeline["topology"] = "TriangleList"
    # sample mask
    if "sample_mask" in pipeline:
        output_pipeline["sample_mask"] = pipeline["sample_mask"]
    else:
        output_pipeline["sample_mask"] = int("0xffffffff", 16)

    return output_pipeline


# return identifier names of valid vertex semantics
def get_vertex_semantics():
    return [
        "BINORMAL",
        "BLENDINDICES",
        "BLENDWEIGHT",
        "COLOR",
        "NORMAL",
        "POSITION",
        "POSITIONT",
        "PSIZE",
        "TANGENT",
        "TEXCOORD"
    ]


# log formatted json
def log_json(j):
    print(json.dumps(j, indent=4), flush=True)


# member wise merge 2 dicts, second will overwrite dest will append items in arrays
def merge_dicts(dest, second, extend = []):
    for k, v in second.items():
        if type(v) == dict:
            if k not in dest or type(dest[k]) != dict:
                dest[k] = dict()
            merge_dicts(dest[k], v, extend)
        elif k in dest and k in extend and type(v) == list and type(dest[k]) == list:
            dest[k].extend(v)
        else:
            dest[k] = v
    return dest


# retuns the array size of a descriptor binding -1 can indicate unbounded, which translates to None
def get_descriptor_array_size(resource):
    if "array_size" in resource:
        if resource["array_size"] == -1:
            return None
        else:
            if resource["array_size"] != None:
                return resource["array_size"]
    return 1


# parses the register for the resource unit, ie. : register(t0)
def parse_register(type_dict):
    rp = cgu.find_token("register", type_dict["declaration"])
    type_dict["shader_register"] = None
    type_dict["register_type"] = None
    type_dict["register_space"] = 0
    if rp != -1:
        start, end = cgu.enclose_start_end("(", ")", type_dict["declaration"], rp)
        decl = type_dict["declaration"][start:end]
        multi = decl.split(",")
        for r in multi:
            r = r.strip()
            if r.find("space") != -1:
                type_dict["register_space"] = cgu.separate_alpha_numeric(r)[1]
            else:
                type_dict["register_type"], type_dict["shader_register"] = cgu.separate_alpha_numeric(r)


# local resource decl will not contain a register mapping, structs do not bind to registers but they declare members
def is_local_resource_decl(type_dict):
    parse_register(type_dict)
    if type_dict["register_type"] == None:
        if len(type_dict["members"]) == 0:
            return True
    return False


# parses a type and generates a vertex layout, array of elements with sizes and offsets
def generate_vertex_layout_slot(members):
    offset = 0
    layout = list()
    for member in members:
        semantic_name, semantic_index = cgu.separate_alpha_numeric(member["semantic"])
        _, _, size = get_type_size_info(member["data_type"])

        # pers instance step rate default is 0 and per instance is 1
        default_step = member["step_rate"]
        if member["input_slot_class"] == "PerInstance" and default_step == 0:
            default_step = 1

        input = {
            "name": member["name"],
            "semantic": semantic_name,
            "index": semantic_index,
            "format": vertex_format_from_type(member["data_type"]),
            "aligned_byte_offset": offset,
            "input_slot": member["input_slot"],
            "input_slot_class": member["input_slot_class"],
            "step_rate": default_step
        }
        offset += size
        layout.append(input)
    return layout


# generate a vertex layout from the supplied vertex shader inputs, overriding where specified in the pmfx
def generate_vertex_layout(vertex_elements, pmfx_vertex_layout):
    # gather up individual slots
    slots = {
    }
    for element in vertex_elements:
        if element["parent"] in pmfx_vertex_layout:
            element = merge_dicts(element, pmfx_vertex_layout[element["parent"]])
        if element["name"] in pmfx_vertex_layout:
            element = merge_dicts(element, pmfx_vertex_layout[element["name"]])
        slot_key = str(element["input_slot"])
        if slot_key not in slots.keys():
            slots[slot_key]= []
        slots[slot_key].append(element)
    # make 1 array with combined slots, and calculate offsets
    vertex_layout = []
    for slot in slots.values():
        vertex_layout.extend(generate_vertex_layout_slot(slot))
    return vertex_layout


# get a list of vertex elements deduced from the input arguments to a vertex shader, ready to be generated into a vertex layout with pipeline specified slot overrides
def get_vertex_elements(pmfx, entry_point):
    slot = 0
    elements = []
    for input in pmfx["functions"][entry_point]["args"]:
        t = input["type"]
        # gather struct inputs
        if t in pmfx["resources"]["structs"]:
            is_vertex = True
            for member in pmfx["resources"]["structs"][t]["members"]:
                semantic, _ = cgu.separate_alpha_numeric(member["semantic"])
                if semantic not in get_vertex_semantics():
                    is_vertex = False
            if is_vertex:
                for member in pmfx["resources"]["structs"][t]["members"]:
                    member_input = dict(member)
                    member_input["parent"] = t
                    member_input["input_slot"] = slot
                    member_input["input_slot_class"] = "PerVertex"
                    member_input["step_rate"] = 0
                    elements.append(member_input)
                slot += 1
        else:
            # gather single elements
            semantic, _ = cgu.separate_alpha_numeric(input["semantic"])
            if semantic in get_vertex_semantics():
                arg_input = dict(input)
                arg_input["parent"] = "args"
                arg_input["data_type"] = arg_input["type"]
                arg_input["input_slot"] = slot
                arg_input["input_slot_class"] = "PerVertex"
                arg_input["step_rate"] = 0
                elements.append(arg_input)
    return elements


# recurses through nested structure to reach and sum the number of 32bit values from primitive types
def structure_get_num_32_bit_values(typename, structs):
    if typename in structs:
        total = 0
        for member in structs[typename]["members"]:

            total += structure_get_num_32_bit_values(member["data_type"], structs)
        return total
    else:
        value = get_num_32bit_values(typename)
        if value == 0:
            print(json.dumps(structs, indent=4))
            print("mssing member {}".format(typename))
            assert(0)
        return value


# builds a descriptor set from resources used in the pipeline
def generate_pipeline_layout(pmfx, pmfx_pipeline, resources):
    bindable_resources = get_bindable_resource_keys()
    pipeline_layout = {
        "bindings": [],
        "push_constants": [],
        "static_samplers": []
    }
    for r in resources:
        resource = resources[r]
        resource_type = resource["type"]
        # check if we have flagged resource as push constants
        if "push_constants" in pmfx_pipeline:
            if r in pmfx_pipeline["push_constants"]:
                # work out how many 32 bit values
                num_values = 0
                for member in resource["members"]:
                    num_values += get_num_32bit_values(member["data_type"])
                # we need to lookup a templated data type
                if num_values == 0:
                    if "template_type" in resource:
                        t = resource["template_type"]
                        num_values = structure_get_num_32_bit_values(t, resources)
                push_constants = {
                    "shader_register": resource["shader_register"],
                    "register_space": resource["register_space"],
                    "binding_type": get_binding_type(resource["register_type"]),
                    "visibility": get_shader_visibility(resource["visibility"]),
                    "num_values": num_values,
                    "name": resource["name"]
                }
                pipeline_layout["push_constants"].append(push_constants)
                continue
        if "static_samplers" in pmfx_pipeline:
            if r in pmfx_pipeline["static_samplers"]:
                lookup = pmfx_pipeline["static_samplers"][r]
                static_sampler = {
                    "shader_register": resource["shader_register"],
                    "register_space": resource["register_space"],
                    "visibility": get_shader_visibility(resource["visibility"]),
                    "sampler_info": pmfx["sampler_states"][lookup],
                    "name": resource["name"]
                }
                pipeline_layout["static_samplers"].append(static_sampler)
                continue
        # fall trhough and add as a bindable resource
        if resource_type in bindable_resources:
            binding = {
                "shader_register": resource["shader_register"],
                "register_space": resource["register_space"],
                "binding_type": get_binding_type(resource["register_type"]),
                "visibility": get_shader_visibility(resource["visibility"]),
                "num_descriptors": get_descriptor_array_size(resource),
                "name": resource["name"]
            }
            pipeline_layout["bindings"].append(binding)

    # combine bindings on the same slot (allow resource type aliasing)
    combined_bindings = dict()
    for binding in pipeline_layout["bindings"]:
        bh = pmfx_hash({
            "shader_register": binding["shader_register"],
            "register_space": binding["register_space"],
            "binding_type": binding["binding_type"]
        })
        if bh not in combined_bindings:
            combined_bindings[bh] = dict(binding)
        else:
            cur = combined_bindings[bh]
            # extend visibility
            if binding["visibility"] != cur["visibility"]:
                cur["visibility"] = "All"

    # sort bindings in index order
    sorted_bindings = list()
    for binding in combined_bindings.values():
        sorted_bindings.append(binding)

    # bubble sort sort them
    sorted = False
    while not sorted:
        sorted = True
        for i in range(0, len(sorted_bindings) - 1):
            j = i + 1
            if sorted_bindings[j]["shader_register"] < sorted_bindings[i]["shader_register"]:
                temp = sorted_bindings[j]
                sorted_bindings[j] = dict(sorted_bindings[i])
                sorted_bindings[i] = dict(temp)
                sorted = False

    pipeline_layout["bindings"] = list(sorted_bindings)

    return pipeline_layout


# wrtie out c++ header from the json info
def write_header(path, pmfx_name, resources):
    src_h = cgu.src_line("namespace pmfx_{} {{".format(pmfx_name))
    if "structs" in resources:
        for struct_name, struct in resources["structs"].items():
            if "members" in struct:
                src_h += cgu.src_line("struct {} {{".format(struct_name))
                for member in struct["members"]:
                    src_h += cgu.src_line("{} {};".format(member["data_type"], member["name"]))
                src_h += cgu.src_line("};")
    src_h += cgu.src_line("}")
    src_h = cgu.format_source(src_h, 4)
    os.makedirs(path, exist_ok=True)
    open(os.path.join(path, "{}.h".format(pmfx_name)), "w+").write(src_h)


# wrtie out rust crate from the json info
def write_rs_crate(path, pmfx_name, resources):
    src_h = cgu.src_line("pub mod pmfx_{} {{".format(pmfx_name))
    if "structs" in resources:
        for struct_name, struct in resources["structs"].items():
            if "members" in struct:
                src_h += cgu.src_line("#[repr(C)]")
                src_h += cgu.src_line("pub struct {} {{".format(struct_name))
                for member in struct["members"]:
                    src_h += cgu.src_line("{}: {},".format(member["name"], member["data_type"]))
                src_h += cgu.src_line("}")
    src_h += cgu.src_line("}")
    src_h = cgu.format_source(src_h, 4)
    os.makedirs(path, exist_ok=True)
    open(os.path.join(path, "{}.rs".format(pmfx_name)), "w+").write(src_h)


# parse metal specific options from command lines, returning (metal_sdk, metal_min_os, metal_version)
def metal_compile_options(info):
    # default to metal 2.0, but allow cmdline override
    metal_version = info.metal_version

    # selection of sdk, macos, ios, tvos
    metal_sdk = "macosx"
    if info.metal_sdk != "":
        metal_sdk = info.metal_sdk

    # insert some defaults fo version min based on os
    metal_min_os = ""
    if metal_sdk == "macosx":
        metal_min_os = "10.11"
        if info.metal_min_os != "":
            metal_min_os = info.metal_min_os
        metal_min_os = "-mmacosx-version-min=" + metal_min_os
    elif metal_sdk == "iphoneos":
        metal_min_os = "9.0"
        if info.metal_min_os != "":
            metal_min_os = info.metal_min_os
        metal_min_os = "-mios-version-min=" + metal_min_os
    elif metal_sdk == "appletvos":
        metal_min_os = "13.0"
        if info.metal_min_os != "":
            metal_min_os = info.metal_min_os
        metal_min_os = "-mtvos-version-min=" + metal_min_os

    # finally set metal -std.
    if metal_sdk == "iphoneos" or metal_sdk == "appletvos":
        metal_version = "-std=ios-metal" + metal_version
    else:
        metal_version = "-std=macos-metal" + metal_version

    return metal_sdk, metal_min_os, metal_version


# convert msl version (ie. 2.1) to spriv msl version 201000 <MMmmpp>
def to_spirv_msl_version(metal_version):
    # spirv msl versions
    msl_version = metal_version.split(".")
    if len(msl_version) < 3:
        msl_version.append("00")
    spirv_msl_version = ""
    for v in msl_version:
        if len(v) < 2:
            v += "0"
        spirv_msl_version += v
    return spirv_msl_version


# cross compile hlsl -> spirv -> metal
def cross_compile_hlsl_metal(info, src, stage, entry_point, temp_filepath, output_filepath):
    exe = os.path.join(info.tools_dir, "bin", "macos", "dxc")

    metal_sdk, metal_min_os, metal_version = metal_compile_options(info)

    error_code = 0
    error_list = []
    output_list = []

    spirv_cross = os.path.join(info.tools_dir, "bin", "macos", "spirv-cross")
    spirv_filepath = os.path.splitext(temp_filepath)[0] + ".spirv"
    cmdline = "{} -T {}_{} -E {} -spirv -Fo {} {}".format(exe, stage, info.shader_version, entry_point, spirv_filepath, temp_filepath)
    ec, el, ol = build_pmfx.call_wait_subprocess(cmdline)
    error_list += el
    output_list += ol

    spirv_msl_version = to_spirv_msl_version(info.metal_version)
    metal_filepath = os.path.splitext(temp_filepath)[0] + ".metal"
    cmdline = "{} --msl --msl-version {} {} --output {}".format(spirv_cross, spirv_msl_version, spirv_filepath, metal_filepath)

    ec, el, ol = build_pmfx.call_wait_subprocess(cmdline)
    error_list += el
    output_list += ol

    air_filepath = os.path.splitext(temp_filepath)[0] + ".air"
    cmdline = "xcrun -sdk {} metal {} {} -c -frecord-sources {} -o {}".format(metal_sdk, metal_min_os, metal_version, metal_filepath, air_filepath)
    ec, el, ol = build_pmfx.call_wait_subprocess(cmdline)
    error_list += el
    output_list += ol

    cmdline = "xcrun -sdk {} metal {} -o {}".format(metal_sdk, air_filepath, output_filepath)
    ec, el, ol = build_pmfx.call_wait_subprocess(cmdline)
    error_list += el
    output_list += ol

    return 0, error_list, output_list


# compile a hlsl version 2
def compile_shader_hlsl(info, src, stage, entry_point, temp_filepath, output_filepath):
    exe = os.path.join(info.tools_dir, "bin", "dxc", "dxc")
    open(temp_filepath, "w+").write(src)
    # compile... or skip
    error_code = 0
    error_list = []
    output_list = []
    if info.compiled:
        if info.shader_platform == "metal":
            error_code, error_list, output_list = cross_compile_hlsl_metal(info, src, stage, entry_point, temp_filepath, output_filepath)
        elif info.shader_platform == "hlsl":
            cmdline = "{} -T {}_{} -E {} -Fo {} {}".format(exe, stage, info.shader_version, entry_point, output_filepath, temp_filepath)
            cmdline += " " + build_pmfx.get_info().args
            error_code, error_list, output_list = build_pmfx.call_wait_subprocess(cmdline)

    output = ""
    if len(error_list) > 0:
        # build output string from error
        output = "\n"
        msg_type = ""
        for err in error_list:
            # highlight errors
            err = replace_error(err)
            err = replace_warning(err)

            # switch between wanring and error colour coding
            if err.find("warning:") != -1:
                msg_type = "warning:"
            elif err.find("error:") != -1:
                msg_type = "error:"

            # add squiggles
            if err.find("^") != -1:
                if msg_type == "error:":
                    err = squiggle_error(err)
                if msg_type == "warning:":
                    err = squiggle_warning(err)

            output += "    " + err + "\n"
        output = output.strip("\n").strip()
    elif len(output_list) > 0:
        # build output string from output message
        output = "\n"
        for out in output_list:
            output += "    " + out + "\n"
        output = output.strip("\n").strip()
    basename = os.path.basename(output_filepath)
    if len(output) > 0:
        print("  compiling: {}\n    {}".format(basename, output), flush=True)
    else:
        print("  compiling: {}".format(basename), flush=True)
    return error_code


# add shader resource for the shader stage
def add_used_shader_resource(resource, stage):
    output = dict(resource)
    if "visibility" not in output:
        output["visibility"] = list()
    output["visibility"].append(stage)
    return output


# add somesbuilt in defines for convenience
def add_built_in_defines(src):
    defines = [
        "#define pmfx_touch(value) (void)(value)"
    ]
    define_src = ""
    for define in defines:
        define_src += define + "\n"
    src = define_src + "\n" + src
    return src


# adds structs to respurces recursively
def add_struct_members_recursive(typename, stage, structs, resources, depth):
    if typename in structs and typename not in resources:
        resources[typename] = add_used_shader_resource(structs[typename], stage)
        resources[typename]["depth"] = depth
        for member in structs[typename]["members"]:
            add_struct_members_recursive(member["data_type"], stage, structs, resources, depth + 1)


# given an entry point generate src code and resource meta data for the shader
def generate_shader_info(pmfx, entry_point, stage, permute=None):
    # resource categories
    resource_categories = get_resource_categories()
    # validate entry point
    if entry_point not in pmfx["functions"]:
        build_pmfx.print_error("  error: missing shader entry point: {}".format(entry_point))
        return None

    # start globals then with entry point src code
    src = pmfx["functions"][entry_point]["source"]

    # grab any attributes
    attribs = pmfx["functions"][entry_point]["attributes"]

    resources = dict()
    recursive_resources = dict()
    vertex_elements = None
    # recursively insert used functions
    complete = False
    added_functions = [entry_point]
    forward_decls = []
    while not complete:
        if permute:
            # evaluate permutations each iteration to remove all dead code
            src = build_pmfx.evaluate_conditional_blocks(src, permute)
        complete = True
        for func in pmfx["functions"]:
            if func not in added_functions:
                if cgu.find_token(func, src) != -1:
                    fwd = pmfx["functions"][func]["source"].replace(pmfx["functions"][func]["body"], ";")
                    forward_decls.append(fwd)
                    added_functions.append(func)
                    # add attributes
                    src = pmfx["functions"][func]["source"] + "\n" + src
                    complete = False
                    break

    # now add used resource src decls
    for category in resource_categories:
        for r in pmfx["resources"][category]:
            tokens = [r]
            resource = pmfx["resources"][category][r]
            # cbuffers with inline decl need to check for usage per member
            if category == "cbuffers":
                for member in resource["members"]:
                    tokens.append(member["name"])
            # types with templates need to include structs
            if cgu.find_token(resource["name"], src) != -1:
                if resource["template_type"] and resource["type"] != "struct":
                    template_typeame = resource["template_type"]
                    if template_typeame in pmfx["resources"]["structs"]:
                        struct_resource = pmfx["resources"]["structs"][template_typeame]
                        resources[template_typeame] = add_used_shader_resource(struct_resource, stage)
                        add_struct_members_recursive(template_typeame, stage, pmfx["resources"]["structs"], recursive_resources, 0)

            # add resource and append resource src code
            for token in tokens:
                p = cgu.find_token(token, src)
                if p != -1:
                    # ignore struct member refernces with names which collide with cbuffer members
                    if resource["type"] == "cbuffer":
                        if cgu.find_prev_non_whitespace(src, p) == ".":
                            continue

                    # add nested members
                    if resource["type"] == "cbuffer" or resource["type"] == "struct":
                        for member in resource["members"]:
                            add_struct_members_recursive(member["data_type"], stage, pmfx["resources"]["structs"], recursive_resources, 1)

                    # add the resource itself
                    resources[r] = add_used_shader_resource(resource, stage)
                    break

    # add any globals..
    globals = ""
    for g in pmfx["globals"]:
        globals += g + "\n"

    # create resource src code
    res = ""

    # adds built in pmfx defines
    res = add_built_in_defines(res)

    # pragmas
    if len(pmfx["pragmas"]) > 0:
        res += "// pragmas\n"
        for pragma in pmfx["pragmas"]:
            res += "{}\n".format(pragma)

    # resources input structs, textures, buffers etc
    added_resources = []
    if len(resources) > 0:
        res += "// resource declarations\n"
        for resource in recursive_resources:
            if resource in added_resources:
                continue
            if recursive_resources[resource]["depth"] > 0:
                res += recursive_resources[resource]["declaration"] + ";\n"
                added_resources.append(resource)

        for resource in resources:
            if resource in added_resources:
                continue
            res += resources[resource]["declaration"] + ";\n"
            added_resources.append(resource)

    # extract vs_input (input layout)
    if stage == "vs":
        vertex_elements = get_vertex_elements(pmfx, entry_point)

    # typedefs
    typedef_decls = cgu.find_typedef_decls(pmfx["source"])
    if len(typedef_decls) > 0:
        res += "// typedefs\n"
        for typedef_decl in typedef_decls:
            res += typedef_decl + ";\n"

    # add fwd function decls
    if len(forward_decls) > 0:
        res += "// function foward declarations\n"
        for fwd in forward_decls:
            res += fwd + "\n"

    # join resource src and src
    src = cgu.format_source(res, 4) + "\n // source\n" + globals + "\n" + cgu.format_source(src, 4)

    if permute:
        # evaluate permutations on the full source including resources
        src = build_pmfx.evaluate_conditional_blocks(src, permute)
        src = cgu.format_source(src, 4)

    return {
        "src": src,
        "src_hash": hashlib.md5(src.encode("utf-8")).hexdigest(),
        "resources": merge_dicts(dict(resources), dict(recursive_resources)),
        "vertex_elements": vertex_elements,
        "attributes": attribs
    }


# generate shader info permutations
def generate_shader_info_permutation(pmfx, entry_point, stage, permute, define_list):
    info = generate_shader_info(pmfx, entry_point, stage, permute)
    if info:
        info["permutation_id"] = build_pmfx.generate_permutation_id(define_list, permute)
    return stage, entry_point, info


# check if we need to compile shaders
def shader_needs_compiling(pmfx, entry_point, hash, output_filepath):
    if not os.path.exists(output_filepath):
        return True
    if "compiled_shaders" in pmfx and entry_point in pmfx["compiled_shaders"]:
        if pmfx["compiled_shaders"][entry_point] != hash:
            return True
        else:
            return False
    else:
        return True


# generate shader permutation
def generate_shader_permutation(build_info, shader_info, stage, entry_point, pmfx, temp_path, output_path):
    if shader_info["permutation_id"] == 0:
        filename = entry_point + "." + stage
    else:
        filename = "{}_{}.{}".format(entry_point, shader_info["src_hash"], stage)
    output_filepath = os.path.join(output_path, filename + "c")
    if shader_needs_compiling(pmfx, entry_point, shader_info["src_hash"], output_filepath):
        temp_filepath = os.path.join(temp_path, filename)
        shader_info["error_code"] = compile_shader_hlsl(build_info, shader_info["src"], stage, entry_point, temp_filepath, output_filepath)
    shader_info["filename"] = "{}/{}c".format(pmfx["pmfx_name"], filename)
    return (stage, entry_point, shader_info)


# auto generates a blend state from a render target blend state, with the default of a single render target blend
# separate alpha is inferred from usage of src_blend_alpha etc and alpha_to_coverage_enabled is default to false
def generate_blend_state(output_pmfx, blend_state_name):
    if blend_state_name in output_pmfx["render_target_blend_states"]:
        rtb = output_pmfx["render_target_blend_states"][blend_state_name]
        independant = False
        if any(x in rtb for x in ["src_blend_alpha", "dst_blend_alpha", "blend_op_alpha"]):
            independant = True
        return {
            "alpha_to_coverage_enabled": False,
            "independent_blend_enabled": independant,
            "render_target": [blend_state_name]
        }
    return None


# generate a pipeline and metadata for permutation
def generate_pipeline_permutation(pipeline_name, pipeline, output_pmfx, shaders, pemutation_id):
    permutation_name = ""
    if pemutation_id > 0:
        permutation_name = str(pemutation_id)
    print("  pipeline: {} {}".format(pipeline_name, permutation_name))
    resources = dict()
    output_pipeline = dict(pipeline)
    
    # gather entry points
    entry_points = list()
    for stage in get_shader_stages():
        if stage in pipeline:
            if type(pipeline[stage]) is list:
                for entry_point in pipeline[stage]:
                    entry_points.append((stage, entry_point, True))
            else:
                entry_points.append((stage,  pipeline[stage], False))

    # clear lib
    if "lib" in output_pipeline:
        output_pipeline["lib_hash"] = 0
        output_pipeline["lib"].clear()
    
    # lookup info from compiled shaders and combine resources
    for (stage, entry_point, lib) in entry_points:
        # check entry exists
        if entry_point not in shaders[stage]:
            output_pipeline["error_code"] = 1
            continue
        # lookup shader info, and redirect to shared shaders
        shader_info = shaders[stage][entry_point][pemutation_id]
        if "lookup" in shader_info:
            lookup = shader_info["lookup"]
            shader_info = dict(shaders[stage][lookup[0]][lookup[1]])
        
        if lib:
            output_pipeline[stage].append(shader_info["filename"])
            output_pipeline["lib_hash"] = pmfx_hash_combine(output_pipeline["lib_hash"], pmfx_hash(shader_info["src_hash"]))
        else:
            output_pipeline[stage] = shader_info["filename"]
            output_pipeline["{}_hash".format(stage)] = pmfx_hash(shader_info["src_hash"])

        shader = shader_info
        resources = merge_dicts(resources, dict(shader["resources"]), ["visibility"])
        # generate vertex layout
        if stage == "vs":
            pmfx_vertex_layout = dict()
            if "vertex_layout" in pipeline:
                pmfx_vertex_layout = pipeline["vertex_layout"]
            output_pipeline["vertex_layout"] = generate_vertex_layout(shader["vertex_elements"], pmfx_vertex_layout)
        # extract numthreads
        if stage == "cs":
            for attrib in shader["attributes"]:
                if attrib.find("numthreads") != -1:
                    start, end = cgu.enclose_start_end("(", ")", attrib, 0)
                    xyz = attrib[start:end].split(",")
                    numthreads = []
                    for a in xyz:
                        numthreads.append(int(a.strip()))
                    output_pipeline["numthreads"] = numthreads

        # set non zero error codes to track failures
        if shader_info["error_code"] != 0:
            output_pipeline["error_code"] = shader_info["error_code"]

    # build pipeline layout
    output_pipeline["pipeline_layout"] = generate_pipeline_layout(output_pmfx, pipeline, resources)

    # fill in any useful defaults
    output_pipeline = get_pipeline_with_defaults(output_pipeline, pipeline)

    # hash the whole thing
    expanded = {
        "pipeline": dict(output_pipeline),
    }

    # adds extra hashes and validates.. in the final output these are simply named keys so they can be looked up
    # to reduce file size bloat, but we need the hash of the expanded data for checking reloads
    if "depth_stencil_state" in pipeline:
        dss = output_pipeline["depth_stencil_state"]
        if dss in output_pmfx["depth_stencil_states"]:
            expanded["depth_stencil_state"] = output_pmfx["depth_stencil_states"][dss]
        else:
            build_pmfx.print_error("  [error] missing depth stencil state '{}'".format(dss))
            output_pipeline["error_code"] = 219

    if "raster_state" in pipeline:
        rs = output_pipeline["raster_state"]
        if rs in output_pmfx["raster_states"]:
            expanded["raster_state"] = output_pmfx["raster_states"][rs]
        else:
            build_pmfx.print_error("  [error] missing raster state '{}'".format(rs))
            output_pipeline["error_code"] = 219

    # we may need to generate some states on the fly for convenience
    added_pmfx = dict()
    added_pmfx["blend_states"] = dict()

    if "blend_state" in pipeline:
        blend_state_name = output_pipeline["blend_state"]
        if blend_state_name not in output_pmfx["blend_states"]:
            blend_state = generate_blend_state(output_pmfx, blend_state_name)
            if blend_state:
                added_pmfx["blend_states"][blend_state_name] = blend_state
                expanded["blend_state"] = dict(blend_state)
                expanded["blend_state"]["exapnded"] = list()
                expanded["blend_state"]["exapnded"].append(blend_state)
                for rt in blend_state["render_target"]:
                    expanded["blend_state"]["exapnded"].append(output_pmfx["render_target_blend_states"][rt])
            else:
                build_pmfx.print_error("  [error] missing blend_state or render_target_blend_state '{}'".format(blend_state_name))
                output_pipeline["error_code"] = 219
        else:
            expanded["blend_state"] = output_pmfx["blend_states"][blend_state_name]
            expanded["blend_state"]["exapnded"] = list()
            for rt in expanded["blend_state"]["render_target"]:
                expanded["blend_state"]["exapnded"].append(output_pmfx["render_target_blend_states"][rt])

    if "static_samplers" in pipeline:
        for (src, sampler) in pipeline["static_samplers"].items():
            if sampler not in output_pmfx["sampler_states"]:
                build_pmfx.print_error("  [error] missing sampler state for static sampler '{}': '{}'".format(src, sampler))
                output_pipeline["error_code"] = 219

    output_pipeline["hash"] = pmfx_hash(expanded)
    # output_pipeline["resources"] = resources

    # need to has the state objects
    output_pmfx

    return (pipeline_name, pemutation_id, output_pipeline, dict(added_pmfx))


# load a pmfx file into dictionary()
def load_pmfx_jsn(filepath, root):
    filepath = os.path.join(root, filepath)
    pmfx = jsn.load_from_file(filepath, [], False)
    all_included_files = []
    all_shader_source = ""
    if "include" in pmfx:
        for include in pmfx["include"]:
            if include.endswith(".pmfx"):
                include_pmfx, shader_source, included_files = load_pmfx_jsn(include, root)
                all_shader_source += "\n" + shader_source
                all_included_files.extend(included_files)
                pmfx = merge_dicts(pmfx, include_pmfx)
            elif include.endswith(".hlsl"):
                shader_source, included_files = build_pmfx.create_shader_set(include, root)
                all_shader_source += "\n" + shader_source
                all_included_files.extend(included_files)
            all_included_files.append(os.path.join(root, include))
    # search through imports and recurively add them to the dependecy list
    import_searched = set()
    to_search = set()
    to_search.add(filepath)
    while len(to_search) > 0:
        fp = to_search.pop()
        import_searched.add(fp)
        file = open(fp, "r").read()
        lines = file.splitlines()
        for line in lines:
            if line.startswith("import"):
                import_name = os.path.join(root, line[line.find(" ")+1:].strip())
                all_included_files.append(import_name)
                if import_name not in import_searched:
                    to_search.add(import_name)
            if line.startswith("{"):
                break
    # strip rouge includes
    if all_shader_source.find("#include") != -1:
        src = all_shader_source.splitlines()
        strip_src = ""
        for line in src:
            if line.find("#include") == -1:
                strip_src += line + "\n"
        all_shader_source = strip_src
    return (pmfx, all_shader_source, all_included_files)


# new generation of pmfx
def generate_pmfx(file, root):
    input_pmfx_filepath = os.path.join(root, file)

    # semi similar to v1-path, allows pmfx: {} and hls source code to be mixed in the ame file
    shader_file_text_full, included_files = build_pmfx.create_shader_set(input_pmfx_filepath, root)
    pmfx_json, shader_source = build_pmfx.find_pmfx_json(shader_file_text_full, False)

    if not pmfx_json:
        pmfx_json, shader_source, included_files = load_pmfx_jsn(file, root)

    # src (input) pmfx dictionary
    pmfx = dict()
    pmfx["pmfx"] = pmfx_json
    pmfx["source"] = cgu.format_source(shader_source, 4)
    pmfx["pmfx_name"] = os.path.splitext(file)[0]

    # create build folders
    build_info = build_pmfx.get_info()
    name = os.path.splitext(file)[0]
    temp_path = os.path.join(build_info.temp_dir, name)
    output_path = os.path.join(build_info.output_dir, name)
    json_filepath = os.path.join(output_path, "{}.json".format(name))
    os.makedirs(temp_path, exist_ok=True)
    os.makedirs(output_path, exist_ok=True)

    # output dictionary
    output_pmfx = {
        "pipelines": dict(),
        "shaders": dict()
    }

    # check deps
    out_of_date = True
    included_files.append(build_info.this_file)
    included_files.append(input_pmfx_filepath)
    if os.path.exists(json_filepath):
        out_of_date = False
        last_built = os.path.getmtime(json_filepath)
        for file in included_files:
            filepath = build_pmfx.sanitize_file_path(os.path.join(build_info.root_dir, file))
            mtime = os.path.getmtime(filepath)
            if mtime > last_built:
                out_of_date = True
                break
        # get hashes from compiled
        try:
            existing = json.loads(open(json_filepath, "r").read())
            if "compiled_shaders" in existing:
                pmfx["compiled_shaders"] = existing["compiled_shaders"]
            # if we have errors, we are also still out of date
            if "error_pipelines" in existing and len(existing["error_pipelines"]) > 0:
                out_of_date = True
            if "dependencies" in existing:
                for dep in existing["dependencies"]:
                    mtime = os.path.getmtime(dep)
                    if mtime > last_built:
                        out_of_date = True
                        break
        except:
            out_of_date = True


    # return if file not out of date
    if not build_info.force:
        if not out_of_date:
            print("{}: up-to-date".format(file))
            return
    print("building: {}".format(build_pmfx.sanitize_file_path(file)))

    # find pragmas
    pmfx["pragmas"] = cgu.find_pragma_statements(pmfx["source"])

    # parse functions
    pmfx["functions"] = dict()
    functions, _ = cgu.find_functions(pmfx["source"])
    for function in functions:
        if function["name"] != "register":
            pmfx["functions"][function["name"]] = function

    # parse types
    pmfx["resources"] = dict()
    for map in get_resource_mappings():
        decls, names = cgu.find_type_declarations(map["identifier"], pmfx["source"])
        if map["category"] not in pmfx["resources"].keys():
            pmfx["resources"][map["category"]] = dict()
        for decl in decls:
            parse_register(decl)
            if is_local_resource_decl(decl):
                continue
            pmfx["resources"][map["category"]][decl["name"]] = decl

    # parse globals
    pmfx["globals"] = set()
    src_lines = pmfx["source"].splitlines()
    for global_type in get_global_types():
        for line in src_lines:
            if line.startswith(global_type):
                pmfx["globals"].add(line)

    # fill state default parameters
    for state_type in get_states():
        if state_type in pmfx["pmfx"]:
            category = pmfx["pmfx"][state_type]
            output_pmfx[state_type] = dict()
            for state in category:
                output_pmfx[state_type][state] = get_state_with_defaults(state_type, category[state])
        else:
            # write place holder of empty sates
            output_pmfx[state_type] = dict()

    # thread pool for compiling shaders and pipelines
    pool = ThreadPool(processes=build_info.num_threads)

    # gather shader list
    compile_jobs = []
    shader_list = list()
    if "pipelines" in pmfx["pmfx"]:
        pipelines = pmfx["pmfx"]["pipelines"]
        for pipeline_key in pipelines:
            pipeline = pipelines[pipeline_key]
            for stage in get_shader_stages():
                if stage in pipeline:
                    if type(pipeline[stage]) is list:
                        for shader in pipeline[stage]:
                            stage_shader = (stage, shader)
                    else:
                        stage_shader = (stage, pipeline[stage])
                        if stage_shader not in shader_list:
                            shader_list.append(stage_shader)

    # gather permutations
    permutation_jobs = []
    pipeline_jobs = []
    if "pipelines" in pmfx["pmfx"]:
        pipelines = pmfx["pmfx"]["pipelines"]
        for pipeline_key in pipelines:
            pipeline = pipelines[pipeline_key]
            pipeline_permutations, permutation_options, mask, define_list, c_defines = build_pmfx.generate_permutations(pipeline_key, pipeline)
            for permute in pipeline_permutations:
                id = build_pmfx.generate_permutation_id(define_list, permute)
                pipeline_jobs.append((pipeline_key, id))
                for stage in get_shader_stages():
                    if stage in pipeline:
                        if type(pipeline[stage]) is list:
                            for shader in pipeline[stage]:
                                permutation_jobs.append(
                                    pool.apply_async(generate_shader_info_permutation, (pmfx, shader, stage, permute, define_list)))
                        else:
                            permutation_jobs.append(
                                pool.apply_async(generate_shader_info_permutation, (pmfx, pipeline[stage], stage, permute, define_list)))

    # wait on shader permutations
    shaders = dict()
    for stage in get_shader_stages():
        shaders[stage] = dict()
    compile_jobs = []
    added_hashes = dict()
    for job in permutation_jobs:
        stage, entry_point, info = job.get()
        if not info:
            continue
        # add an entry
        if entry_point not in shaders[stage]:
            shaders[stage][entry_point] = dict()
        hash = str(info["src_hash"]) + stage
        shaders[stage][entry_point][info["permutation_id"]] = info
        if hash not in added_hashes:
            added_hashes[hash] = (entry_point, info["permutation_id"])
            compile_jobs.append(
                pool.apply_async(generate_shader_permutation, (build_info, info, stage, entry_point, pmfx, temp_path, output_path)))
        else:
            shaders[stage][entry_point][info["permutation_id"]]["lookup"] = added_hashes[hash]

    # wait on shader compilation
    for job in compile_jobs:
        (stage, entry_point, info) = job.get()
        shaders[stage][entry_point][info["permutation_id"]] = info
        shader_name = info["filename"]
        output_pmfx["shaders"][shader_name] = pmfx_hash(info["src_hash"])

    # generate pipeline reflection info
    pipeline_compile_jobs = []
    for job in pipeline_jobs:
        pipeline_compile_jobs.append(
            pool.apply_async(generate_pipeline_permutation, (job[0], pipelines[job[0]], output_pmfx, shaders, job[1])))

    # wait on pipeline jobs and gather results
    for job in pipeline_compile_jobs:
        (pipeline_name, permutation_id, pipeline_info, added_pmfx) = job.get()
        if pipeline_name not in output_pmfx["pipelines"]:
            output_pmfx["pipelines"][pipeline_name] = dict()
        output_pmfx["pipelines"][pipeline_name][permutation_id] = pipeline_info
        output_pmfx = merge_dicts(dict(output_pmfx), dict(added_pmfx))

    # write c-header
    if build_info.struct_dir and len(build_info.struct_dir) > 0:
        write_header(build_info.struct_dir, pmfx["pmfx_name"], pmfx["resources"])

    # write rs-crate
    if build_info.crate_dir and len(build_info.crate_dir) > 0:
        write_rs_crate(build_info.crate_dir, pmfx["pmfx_name"], pmfx["resources"])

    # timestamp / dependency info
    dependency_set = list()
    for file in included_files:
        abs_file = os.path.abspath(file)
        if abs_file not in dependency_set:
            dependency_set.append(abs_file)

    # add this file as a dep for non frozen builds (.py not .exe)
    if not getattr(sys, 'frozen', False):
        dependency_set.append(os.path.realpath(__file__))

    output_pmfx["filepath"] = os.path.abspath(json_filepath)
    output_pmfx["dependencies"] = dependency_set

    # find any error pipelines and record them so we can trigger rebuilds
    error_pipelines = []
    build_info.error_code = 0
    for pipeline in output_pmfx["pipelines"]:
        for permutation in output_pmfx["pipelines"][pipeline]:
            if "error_code" in output_pmfx["pipelines"][pipeline][permutation]:
                build_info.error_code = output_pmfx["pipelines"][pipeline][permutation]["error_code"]
                error_pipelines.append(pipeline)
                continue

    # validate render graphs
    if False:
        for graph_name, graph in output_pmfx["render_graphs"].items():
            for node_name, node in graph.items():
                if "view" in node:
                    v = node["view"]
                    if node["view"] not in output_pmfx["views"]:
                        build_pmfx.print_warning("  [warning] missing view: '{}' in render graph {}: {}".format(v, graph_name, node_name))
                if "pipelines" in node:
                    for p in node["pipelines"]:
                        if p not in output_pmfx["pipelines"]:
                            build_pmfx.print_warning("  [warning] missing pipeline: '{}' in render graph {}: {}".format(p, graph_name, node_name))
                if "depends_on" in node:
                    for d in node["depends_on"]:
                        if d not in graph:
                            build_pmfx.print_warning("  [warning] missing depends_on: '{}' in render graph {}: {}".format(d, graph_name, node_name))


    # write info per pmfx, containing multiple pipelines
    output_pmfx["error_pipelines"] = error_pipelines
    open(json_filepath, "w+").write(json.dumps(output_pmfx, indent=4))

    # return errors
    if build_info.error_code != 0:
        sys.exit(build_info.error_code)

    return 0


# entry point wrangling
def main():
    build_pmfx.main(generate_pmfx, "2.0")


# entry
if __name__ == "__main__":
    main()