chromium/third_party/vulkan-validation-layers/src/layers/state_tracker/fence_state.h

/* Copyright (c) 2015-2024 The Khronos Group Inc.
 * Copyright (c) 2015-2024 Valve Corporation
 * Copyright (c) 2015-2024 LunarG, Inc.
 * Copyright (C) 2015-2024 Google Inc.
 * Modifications Copyright (C) 2020 Advanced Micro Devices, Inc. All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

#include "state_tracker/state_object.h"
#include "state_tracker/submission_reference.h"
#include <future>

class ValidationStateTracker;

namespace vvl {

class Queue;
class Swapchain;

//
// AcquireFenceSync synchronization is when a fence from the AcquireNextImage call is used to
// synchronize with queue submissions that generated one of the previous frames.
// This is in contrast to a more common approach when the fence from QueueSubmit is used for
// host synchronization.
//
// The sequence that connects image acquire fence to one of the previous submissions
// (in chronologically backward order):
//  a) the wait on the image acquire fence is finished ->
//  b) the corresponding image is acquired ->
//  c) the previous presentation of this image is finished (except for the first acquire) ->
//  d) corresponding present request finished waiting on the queue submit semaphore ->
//  e) corresponding queue batch finished execution and signaled that semaphore
//
// Acquire fence synchronization allows the use of the fence from step a) to wait on the submit batch from step e).
//
struct AcquireFenceSync { … };

class Fence : public RefcountedStateObject { … };

}  // namespace vvl