نمودارها

می‌توان یک پروتوباف «گزینه‌های نمودار» را برای یک گراف MediaPipe مشابه پروتوباف Calculator Options مشخص‌شده برای یک ماشین حساب MediaPipe تعیین کرد. این "گزینه های نمودار" را می توان در جایی که یک گراف فراخوانی می شود مشخص کرد و برای پر کردن گزینه های ماشین حساب و گزینه های فرعی در نمودار استفاده کرد.

در CalculatorGraphConfig ، گزینه های گراف را می توان برای یک زیرگراف دقیقاً مانند گزینه های ماشین حساب مشخص کرد، همانطور که در زیر نشان داده شده است:

node {
  calculator: "FlowLimiterCalculator"
  input_stream: "image"
  output_stream: "throttled_image"
  node_options: {
    [type.googleapis.com/mediapipe.FlowLimiterCalculatorOptions] {
      max_in_flight: 1
    }
  }
}

node {
  calculator: "FaceDetectionSubgraph"
  input_stream: "IMAGE:throttled_image"
  node_options: {
    [type.googleapis.com/mediapipe.FaceDetectionOptions] {
      tensor_width: 192
      tensor_height: 192
    }
  }
}

در CalculatorGraphConfig ، گزینه‌های نمودار را می‌توان پذیرفت و برای پر کردن گزینه‌های ماشین حساب، مانند شکل زیر، استفاده کرد:

graph_options: {
  [type.googleapis.com/mediapipe.FaceDetectionOptions] {}
}

node: {
  calculator: "ImageToTensorCalculator"
  input_stream: "IMAGE:image"
  node_options: {
    [type.googleapis.com/mediapipe.ImageToTensorCalculatorOptions] {
        keep_aspect_ratio: true
        border_mode: BORDER_ZERO
    }
  }
  option_value: "output_tensor_width:options/tensor_width"
  option_value: "output_tensor_height:options/tensor_height"
}

node {
  calculator: "InferenceCalculator"
  node_options: {
    [type.googleapis.com/mediapipe.InferenceCalculatorOptions] {}
  }
  option_value: "delegate:options/delegate"
  option_value: "model_path:options/model_path"
}

در این مثال، FaceDetectionSubgraph گزینه گراف protobuf FaceDetectionOptions را می پذیرد. FaceDetectionOptions برای تعریف برخی از مقادیر فیلد در گزینه های ماشین حساب ImageToTensorCalculatorOptions و برخی از مقادیر فیلد در گزینه های فرعی InferenceCalculatorOptions استفاده می شود. مقادیر فیلد با استفاده از syntax option_value: تعریف می شوند.

در CalculatorGraphConfig::Node protobuf، فیلدهای node_options: و option_value: با هم مقادیر گزینه را برای ماشین حسابی مانند ImageToTensorCalculator تعریف می کنند. فیلد node_options: مجموعه ای از مقادیر ثابت تحت اللفظی را با استفاده از نحو متنی protobuf تعریف می کند. هر فیلد option_value: مقدار یک فیلد پروتوباف را با استفاده از اطلاعات نمودار محصور کننده، به‌ویژه از مقادیر فیلد گزینه‌های گراف گراف محصور، تعیین می‌کند. در مثال بالا، option_value: "output_tensor_width:options/tensor_width" فیلد ImageToTensorCalculatorOptions.output_tensor_width را با استفاده از مقدار FaceDetectionOptions.tensor_width تعریف می‌کند.

نحو option_value: شبیه نحو input_stream: . نحو عبارت option_value: "LHS:RHS" . LHS یک فیلد گزینه ماشین حساب و RHS یک فیلد گزینه گراف را مشخص می کند. به طور خاص، LHS و RHS هر کدام از یک سری نام فیلدهای protobuf تشکیل شده‌اند که پیام‌های protobuf تودرتو و فیلدهایی را که با «/» از هم جدا شده‌اند، شناسایی می‌کنند. این به عنوان نحو "ProtoPath" شناخته می شود. پیام‌های تودرتو که در LHS یا RHS ارجاع می‌شوند باید قبلاً در protobuf محتوی تعریف شده باشند تا با استفاده از option_value: .

class UnitDelayCalculator : public Calculator {
 public:
  static absl::Status FillExpectations(
      const CalculatorOptions& extendable_options, PacketTypeSet* inputs,
      PacketTypeSet* outputs, PacketTypeSet* input_side_packets) {
    inputs->Index(0)->Set<int>("An integer.");
    outputs->Index(0)->Set<int>("The input delayed by one time unit.");
    return absl::OkStatus();
  }

  absl::Status Open() final {
    Output()->Add(new int(0), Timestamp(0));
    return absl::OkStatus();
  }

  absl::Status Process() final {
    const Packet& packet = Input()->Value();
    Output()->AddPacket(packet.At(packet.Timestamp().NextAllowedInStream()));
    return absl::OkStatus();
  }
};

node {
  calculator: 'GlobalCountSourceCalculator'
  input_side_packet: 'global_counter'
  output_stream: 'integers'
}
node {
  calculator: 'IntAdderCalculator'
  input_stream: 'integers'
  input_stream: 'old_sum'
  input_stream_info: {
    tag_index: ':1'  # 'old_sum'
    back_edge: true
  }
  output_stream: 'sum'
  input_stream_handler {
    input_stream_handler: 'EarlyCloseInputStreamHandler'
  }
}
node {
  calculator: 'UnitDelayCalculator'
  input_stream: 'sum'
  output_stream: 'old_sum'
}