source/slang/ir-link.h


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

// ir-link.h
#pragma once

#include "compiler.h"

namespace Slang
{
    // Interface to IR specialization for use when cloning target-specific
    // IR as part of compiling an entry point.

    // `IRSpecializationState` is used as an opaque type to wrap up all
    // the data needed to perform IR specialization, without exposing
    // implementation details.
    struct IRSpecializationState;
    IRSpecializationState* createIRSpecializationState(
        EntryPointRequest*  entryPointRequest,
        ProgramLayout*      programLayout,
        CodeGenTarget       target,
        TargetRequest*      targetReq);
    void destroyIRSpecializationState(IRSpecializationState* state);
    IRModule* getIRModule(IRSpecializationState* state);

    struct ExtensionUsageTracker;

    // Clone the IR values reachable from the given entry point
    // into the IR module associated with the specialization state.
    // When multiple definitions of a symbol are found, the one
    // that is best specialized for the given `targetReq` will be
    // used.
    IRFunc* specializeIRForEntryPoint(
        IRSpecializationState*  state,
        EntryPointRequest*  entryPointRequest);
}